ForHosting KIT · 開発者向けツール

色相角で色が暖色か寒色かを判定

この判定ツールは、16進カラーを色相角へ変換し、固定された暖色と寒色の中心と比較します。0度の赤を暖色の中心、180度のシアンを寒色の中心とし、近い側を結果にします。境界上の色相は、常に同じ結果になるよう寒色として扱います。正規化した色、色相、分類、角距離を返すため、デザインツール、テスト、自動処理でも判断根拠が明確で、同じ入力から同じ結果を再現できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

暖色と寒色を決める仕組み

標準的なRGB色相環に幾何学的な規則を適用します。0度の赤は暖色側の中心、180度のシアンは寒色側の中心です。入力された16進カラーを色相へ変換した後、赤までの最短角距離を求めます。90度未満なら暖色、90度以上なら寒色です。したがって境界は90度と270度にあります。この2点は両中心から等距離なので、厳密な同点は寒色に統一します。境界でアプリごとに結果が変わることを防ぐための明示的な規則です。結果には計算した色相と距離も含まれ、判定を検証できます。これはデジタルカラー向けの実用的な分類であり、周囲の色、照明、文化的背景によって人が感じる温度感まで固定するものではありません。

色の入力方法と結果の読み方

#F60のような3桁、または#FF6600のような6桁の16進RGBカラーを入力してください。先頭の#は省略でき、英字の大文字と小文字は区別しません。短縮形は展開され、colorフィールドには大文字の6桁値が返ります。hue_degreesは0以上360未満の計算済み位置、categoryは暖色または寒色の分類です。distance_from_warm_centerは色相環の短い経路で赤から何度離れているかを示し、2つの中心フィールドは基準角を示します。距離が90度に近い色は境界付近なので、見た目が周囲に左右される場合がありますが、計算結果は変わりません。黒、白、完全な灰色はRGB各値が等しく色相を定義できないため、根拠のない分類をせず入力エラーにします。

自動処理で一貫した分類を使う方法

人が毎回判断せずにパレットを絞り込み、検査し、処理先を分けたい場合に役立ちます。デザインシステムのスクリプトでは、暖色コレクションに暖色の結果だけが含まれるか確認できます。商品カタログでは色見本へ検索可能な温度分類を付けられます。グラフ生成では補助色を選ぶ前に分類を調べ、対照的な系統を選択できます。通信、乱数、保存状態、現在時刻を使わないため、同じ入力は必ず同じ出力になります。APIによる自動化は1リクエスト $0.002 で、ブラウザー版も同じ純粋な計算を実行します。この分類は測定可能な一属性であり、色の見え方すべてを説明する理論ではありません。彩度と明度は色相角を変えませんが、温度感には影響します。最終的には予定する背景や隣接色と並べてご確認ください。

活用例

デジタルパレットの整理

デザインの最終確認前に、色のある16進見本を一貫した暖色群と寒色群へ分けます。

デザイントークンのテスト

編集後もテーマ用のセマンティックトークンが想定した色相側にあるか検証します。

商品カラーへの分類付与

カタログの色見本へ一定の温度分類を追加し、絞り込みや商品管理に利用します。

よくある質問

どの角度が暖色ですか？

0度の赤までの最短距離が90度未満の色相です。0度以上90度未満と、270度超360度未満が該当します。

境界上ではどう判定しますか？

正確に90度または270度なら両中心から等距離です。一貫した規則により寒色と判定します。

灰色、黒、白を扱えないのはなぜですか？

RGB各値が等しく、色相角を定義できないためです。分類すると色相に基づく規則と矛盾します。

彩度や明るさで分類は変わりますか？

変わりません。見え方には影響しますが、この機能は色相角だけを意図的に使用します。

どの色形式を入力できますか？

先頭の#がある、またはない3桁と6桁の16進RGBに対応します。アルファ値と色名には対応しません。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/color/warm-or-cool

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/color/warm-or-cool \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"color":"#E85D04"}'

const res = await fetch("https://api.kit.forhosting.com/color/warm-or-cool", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "color": "#E85D04"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/warm-or-cool",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "color": "#E85D04"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/warm-or-cool", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"color":"#E85D04"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"color":"#E85D04"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/warm-or-cool", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "color": "#E85D04"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.warm_or_cool",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →