提供期間 APIが拡張されました。

新しいAPI V3.0: 特別価格でAPIを入手できます。今すぐアクセスしてください。ウェブプロジェクト、プラグイン、社内ツール、SaaSアプリケーションに最適です。2025-10-21 から 2025-11-21 (23:59 CET) まで有効です。

APIパッケージと価格 X

V3.0 新規 – qConv.com 関連色 - API ドキュメント

qConv関連色APIを使用すると、RGB、HEX、CMYK、PANTONE®、RAL、HKS、NCS、およびカスタム メーカー パレットなど、ソース カラーから一致する色を取得できます。
重要: RAL、Pantoneなどのメーカーやカラー パレットでは、最も近い一致するパレット カラーが常に返されます。

🔑 認証

qConv APIはAPIキーを使用します。

URLパラメータによる認証

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[APIキー]

注意:キーはBase64URLエンコード(URL互換)されており、安全です。

🔗 終点

GET https://qconv.com/api/v3.0/color.php

📥 お問い合わせパラメーター

パラメータ タイプ 必須 概要
from string ✅ はい 色の出典形式(rgb、ral、behrなどのメーカー名など
input string ✅ はい 入力値(例:FF0000
apikey string ✅ はい 個人用の秘密のAPIキー

対応フォーマット

カラーフォーマット

rgb hex cmyk pantone ral hks ncs sw

メーカーカラー

以下のリンク先のメーカーページにあるメーカーコードはすべて有効な値です。

https://qconv.com/ja/会

メーカーのウェブサイトの左側の欄にあるAPIコードリファレンス、またはこのシンボルを探してください。:

✅ お問い合わせ例

六角形

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[APIキー]

答えてくれ:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "related": {
        "comp": {
            "rgb": "0 255 255",
            "hex": "#00FFFF",
            "cmyk": "100 0 0 0",
            "hsl": "180 1 0.5",
            "lab": "91.12 -48.08 -14.14"
        },
        "dark": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "rgb": "255 0 136",
                "hex": "#FF0088",
                "cmyk": "0 100 47 0",
                "hsl": "328 1 0.5",
                "lab": "55.11 85.15 -0.4"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "rgb": "172 0 0",
                "hex": "#AC0000",
                "cmyk": "0 100 100 33",
                "hsl": "0 1 0.34",
                "lab": "35.54 59.64 49.89"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            }
        ],
        "sat_less": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 1,
        "max_tokens": 50,
        "percentage_used": "2 %"
    }
}

メーカーカラー BEHR

GET /api/v3.0/color.php?from=behr&input=p120-7 glitterati&apikey=[APIキー]

答えてくれ:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "behr",
    "input": "p120-7 glitterati",
    "related": {
        "comp": {
            "manufacturer": "Behr",
            "name": "mq6-41 farmer´s market",
            "rgb": "113 184 151",
            "hex": "#71B897",
            "cmyk": "39 0 18 28",
            "hsl": "152.11 0.33 0.58",
            "lab": "69.49 -29.81 9.81"
        },
        "dark": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "mfg": "Behr",
                "name": "ppu1-16 haitian flower",
                "rgb": "151 73 90",
                "hex": "#97495A",
                "cmyk": "0 52 40 41",
                "hsl": "346.92 0.35 0.44",
                "lab": "41.35 34.47 5.42"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "mfg": "Behr",
                "name": "p110-7 xoxo",
                "rgb": "145 80 123",
                "hex": "#91507B",
                "cmyk": "0 45 15 43",
                "hsl": "320.31 0.29 0.44",
                "lab": "43.04 33.27 -12.51"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "mfg": "Behr",
                "name": "bxc-21 chicory root",
                "rgb": "95 66 63",
                "hex": "#5F423F",
                "cmyk": "0 31 34 63",
                "hsl": "5.63 0.2 0.31",
                "lab": "31.09 12.12 6.83"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_less": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 2,
        "max_tokens": 50,
        "percentage_used": "4 %"
    }
}

📦 応答体制

フィールド タイプ 概要
api_version string 現在使用されているAPIのバージョンを返します。
timestamp string ISO 8601形式のリクエストのタイムスタンプ、例:'2025-08-14T13:42:00+01:00'
http_response_code string レスポンスのHTTPステータスコード(200、400、500など)。リクエストが成功したか、エラーを返したかを示します。
from string 送信出力フォーマット
input string 送信元の値
related object 関連フィールドには、転送された色から計算される関連する色調が含まれます。これらには、補色、明るい色と暗い色のバリエーション、およびトライアド (triad) やテトラッド (tetrad) のようなカラーハーモニーが含まれます。詳しくは関連の詳細.
user_data object 使用されたコンバージョン数など、APIアカウントに関する情報。
error string エラーが発生した場合:エラーコード、説明などの詳細が記載されたオブジェクト。照会が成功した場合、このフィールドはゼロまたは存在しません。

関連記事

カラータイプ タイプ 概要
comp object 補色、すなわちカラーホイール上の反対色。
dark array オリジナルカラーを5段階まで濃くしたグラデーション。
light array 最大5色の明るいグラデーション。
ana array カラーホイール上で近接する最大5つの色調。
mono array 同じ基本色で明度や彩度を変えたモノクロバリエーションを最大5つまで。
warm array 赤や黄色にわずかにシフトした色合い。
cold array より青みがかった色合いや紫がかった色合いなど、より寒色系のバリエーションが5色まである。
sat_more array 彩度を高めた最大5色(より強く、より強烈な効果)。
sat_less array 彩度を下げた5色まで(落ち着いた、より抑制された効果)。
split array スプリット・コンプリメンタリー・スキームの3色 - 補色の隣にある2つのトーン。
triad array トライアド配色-カラーホイール上に均等に配置された3色。
tetrad array テトラディック配色 - カラーホイール上で長方形を形成する4色。
square array

各オブジェクトには以下の値が含まれる。

カラー・バリュー タイプ 概要
mfg string / null あれば塗料メーカー名(Behr、OBI、RALなど)。
name string / null もしあれば、メーカーの公式色指定。
rgb string スペースで区切られたRGB値(例:'113 184 151')。
hex string 16進数のカラーコード(例:'#71B897')。
cmyk string CMYK表現(印刷またはデザイン用途のパーセンテージ値)。
hsl string 色調、彩度、明度(色相、彩度、明度)。
lab string CIELAB色空間の値で、正確な色比較と色分析に適している。

⚠️ エラーコード

ステータスコード 意味
400 パラメータの欠落または無効
401 無効または見つからないAPIキー
429 月間API上限に到達
500 内部サーバーエラー

APIキーがない場合、または間違ったAPIキーが入力された場合:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

入力がない場合、または準拠しない値が入力された場合:

{
    "api_version" => "v3.0",    
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 400,
    "error": "Missing input or from" | "Conversion failed or input invalid",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

📈 API制限と課金

各APIキーには月間上限があります。無料はAPIキー1つにつき50トークン/月です。
API-KEYは2つまで無料で作成することができます。
アップグレードにより、さらに拡張することができます:
Basic-APIの料金プランでは、それぞれ200トークン5つのAPI-KEYを作成することができます(∑1.
Premium API の料金プランでは、10個のAPI-KEY1.
Voyager API の料金プランでは、それぞれ10,000トークン50個のAPI-KEYを作成できます(∑500,000トークン)。
特別なご要望があれば、いつでもカスタマイズしたオファーをご用意することも可能です。お気軽にお問い合わせください。

リミットに達すると

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 429,
    "error": "Hello USER #12345, your monthly API quota of 50 requests has been used up. Please contact [email protected] to upgrade or wait for the next reset.",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

🛠️ APIマネージャー

APIキーの管理(追加/削除)

総使用量とAPI関連使用量を表示

アップグレードにより毎月の限度額を増やす

新しいキーを生成する(Base64URLセーフ)

より良い差別化のためにコメントを追加

🔒 セキュリティ

すべてのパラメータはGETで送信される。

キーごとのレート制限(オプション

32バイト長のBase64URLキー

🧼 開発者向け注意事項

すべてのパラメータは大文字と小文字を区別しない

ヘックスコードは#では使用できません:有効なのはFF0000のみです。

255,0,0 または 255 0 0 for RGB

185C185 CはPANTONEのために働く。

サポート

注意: 技術的な理由により、メーカー名によっては結果が表示されないことがあります。ヘルプが必要な場合、または記載されていないその他の理由で変換がうまくいかない場合は、info[at]qconv.com までご連絡ください。'Basic API Service'からのお客様にはサポートを提供しております。

🆕 変更履歴

API-V3.0:

  • NEW:透過色について、補色、明色、暗色、暖色、寒色などのそれぞれの関連色を取得できるようになりました。この目的のために/api/color.phpを作成しました。
  • LABとHSLカラーが答えに統合されました。

  • NEW:'used_tokens'

  • NEW:'max_tokens'オブジェクトuser_dataでは、識別子'max tokens'をアンダースコアで標準化しました。

  • NEW:'percentage_used'
    オブジェクトuser_dataでは、識別子'percentage used'をアンダースコアで標準化しました。

2025-10-21

API-V2.0:

  • 色差は、メーカー変換時にdE00形式(Delta E 2000)の色差値としても出力されるようになりました。
  • 色指定(Sherwin Williams、NCS(ドイツ語)、HEXまたはRGB)がある場合、これが出力されます。
  • APIのバージョン番号とタイムスタンプも出力される
  • 誤入力の場合は、その理由についての詳細な情報が提供されます。

2025-08-14

API-V1.0:

  • ウェブサイトに統合されたAPI

2025-07-15

カラーパレットを保存するには、登録が必要です。

アカウントにログインする

または

アカウントの作成

現在のカラーパレット 共有
公開か非公開か?
共有後、リンク(複数可)が続きます。

カラーパレットの共有
ご希望のリンクをコピーして保存してください。

シェア

OK、リンクをコピーしておきました

あなたの色は新しいカラーパレットに保存されます。
プロフィールの下に表示されます。
さらにカスタマイズしたり、共有することもできます。

カラーパレットの作成

ダウンロード各種フォーマットでダウンロード

すべて削除

をクリックすると、パレットを作成し、色見本をダウンロードすることができます。