现在是优惠期 我们的 API 已扩展

新的应用程序接口 V3.0: 以特价获取我们的 API。立即访问。使用更详细的色彩转换结果--非常适合网络项目、插件、内部工具或 SaaS 应用程序。有效期为 2025-10-21 至 2025-11-21 (23:59 CET)（含 PLACEHOLDER_3

API 套餐和价格 X
API-V1.0 API-V2.0 API-V3.0 新
< 致 API 管理员

目录

🔑 认证

通过 URL 参数验证

🔗 终点

📥查询参数

支持的格式

✅ 查询示例

📦 响应结构

⚠️ 错误代码

📈 API 限制和计费

🛠️ 应用程序接口管理器

🔒 安全

🧼 开发人员注意事项

🆕 更改日志

V3.0 新 – qConv.com 相关颜色 - API 文档

Convert-API V3.0 Color-API V3.0 新

使用 qConv 相关颜色 API，您可以从源颜色（包括 RGB、HEX、CMYK、PANTONE®、RAL、HKS、NCS 和自定义制造商调色板）中获取匹配的颜色。

🔑 认证

qConv API 使用 API 密钥，您可以通过配置文件管理这些密钥。

通过 URL 参数验证

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[您的应用程序接口密钥]

注意：密钥采用 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/zh/制造商

在制造商网站的左侧栏中查找 API 代码参考或此符号:

✅ 查询示例

六角形

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[您的应用程序接口密钥]

请回答：

{
    "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_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 版本，如 'v2
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 相关字段包含根据转移的颜色计算出的相关色调。其中包括互补色、浅色和深色变体以及三原色或四原色等调和色。更多信息，请参见相关详情。
user_data object 有关 API 账户的信息，如使用的转换次数。
error string 如果出现错误：包含错误代码、描述等详细信息的对象。如果查询成功，则该字段为零或不存在

相关详细内容

颜色类型 类型 说明
comp object 补色，即色轮上的相反颜色。
dark array 原色的渐变色，最多可有五种深色变体。
light array 多达五个浅色变体的渐变色。
ana array 色轮上最多有五个相邻的色调。
mono array 同一基本色最多可有五种不同亮度或饱和度的单色变化。
warm array 多达五种较暖的颜色变体--略微偏向红色或黄色的色调。
cold array 多达五种偏冷的颜色--偏蓝或偏紫的色调。
sat_more array 多达五种颜色，色彩饱和度更高（效果更强、更强烈）。
sat_less array 最多五种饱和度降低的颜色（柔和、内敛的效果）。
split array 分色互补方案中的三种颜色--互补色旁边的两种色调。
triad array 三原色配色方案--三种颜色在色轮上均匀分布。
tetrad array 四分色配色方案--四种颜色在色轮上形成一个矩形。
square array

每个对象包含以下值

颜色值 类型 说明
mfg string / null 涂料制造商的名称（如 Behr、OBI、RAL）。
name string / null 制造商的官方颜色名称（如有）。
rgb string RGB 值，用空格分隔（如 '113 184 151'）。
hex string 十六进制颜色代码（如 '#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 密钥每月 50 个令牌。最多可免费创建 2 个 API-KEY 。

可通过升级扩展：
使用 Basic-API 费率，您可以创建 5 个 API-KEY ，每个 200 个令牌（∑ 1.
使用 Premium API关税，您可以创建 10 个 API-KEYs ，每个200 个代币（∑ 1.
使用 Voyager API 收费标准，您可以创建 50 个 API-KEYs 每个 10,000 个代币（∑ 10,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 相关使用量

通过升级提高每月限额

生成新密钥（Base64URL-safe）

为更好地区分添加评论

🔒 安全

所有参数均通过 GET 发送

每个按键的速率限制可选

32 字节长 Base64URL 密钥

🧼 开发人员注意事项

所有参数均大小写敏感

不能使用 # 的十六进制编码：只有 FF0000 有效

255,0,0 或 255 0 0 用于 RGB

185C 和 185 C 适用于 PANTONE

支持

注意：由于技术原因，可能会出现某些制造商名称没有显示结果的情况。如果您需要帮助或由于其他未提及的原因导致转换失败，请通过 info[at]qconv.com 联系我们。我们为'基本 API 服务'的客户提供支持。

🆕 更改日志

API-V3.0:

  • 新功能：现在可以为传输的颜色获取相应的相关颜色，如互补色、浅色、深色、暖色、冷色等。为此，我们创建了 /api/color.php。
  • 答案中集成了 LAB 和 HSL 颜色
  • 在 user_data 对象中，我们使用下划线对标识符 '已使用的标记 '进行了标准化处理。
  • 在 user_data 对象中，我们用下划线规范了标识符 'max tokens'。
  • 在 user_data 对象中，我们使用下划线对标识符 '已用百分比 '进行了标准化处理。

2025-10-21

API-V2.0:

  • 现在，在转换为制造商的颜色时，色差也会以 dE00 格式（Delta E 2000）输出。
  • 如果有颜色名称（Sherwin Williams、NCS（德国）、HEX 或 RGB），则输出该名称
  • 还会输出应用程序接口版本号和时间戳
  • 如果输入错误，将提供更详细的原因信息

2025-08-14

API-V1.0:

  • 网站集成了应用程序接口

2025-07-15

要保存调色板，需要进行注册。

登录您的账户

或

创建账户

分享当前的调色板
是公开的还是私人的？
分享后会有链接。

取消 分享

共享调色板
请复制并保存所需的链接。

分享

好的，我复制了链接

您的颜色会保存在一个新的调色板中。
在您的个人档案中查看它们。
您可以进一步自定义并共享它们。

显示调色板
关闭

创建调色板

下载以各种格式下载

全部删除

点击 可以创建调色板并下载 色板。

© 2019-2025 - Designed by frag-bobby.de