Dear color lovers – together, we’ll have a more colorful future. Support us on

V3.0 – qConv.com 转换器 - API 文档

使用 qConv Converter API，您可以在不同格式之间转换颜色，包括 RGB、HEX、CMYK、PANTONE®、RAL、HKS、NCS 和自定义制造商调色板。

🔑 认证

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

通过 URL 参数验证

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

注意：密钥采用 Base64URL 编码（与 URL 兼容），并且是安全的。

🔗 终点

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

📥 查询参数

参数	类型	需要	说明
from	string	✅ 是	颜色的来源格式，如 rgb、ral 或制造商名称，如 behr
input	string	✅ 是	输入值，例如：<代码>FF0000
to	string	✅ 是	颜色的目标格式，如十六进制、cmyk 或制造商名称，如 Caparol 颜色
apikey	string	✅ 是	您的个人和秘密 API 密钥

支持的格式

颜色格式

rgb hex cmyk pantone ral hks ncs sw

+ 制造商颜色

您在以下链接下的制造商页面上找到的所有制造商代码都是有效值。

https://qconv.com/zh/制造商

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

✅ 查询示例

六角形至灰度

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

请回答：

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "to": "rgb",
    "result": "255 165 0",
    "name": "Orange",
    "more_conversions": {
        "pantone": "137",
        "ral":     "1028",
        "hks":     "5",
        "rgb":     "255 165 0",
        "hex":     "#FFA500",
        "cmyk":    "0 35 100 0",
        "sw":      "6905",
        "ncs":     "S0580-Y30R",
        "hsl":     "38.82 1 0.5",
        "lab":     "74.93 23.94 78.96"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 1,
        "max tokens": 50,
        "percentage used": "2 %"
    }
}

灰度至制造商颜色 BEHR

GET /api/v3.0/convert.php?from=rgb&input=145, 25, 100&to=behr&apikey=[您的应用程序接口密钥]

请回答：

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "rgb",
    "input": "145, 25, 100",
    "to": "behr",
    "result": "p120-7 glitterati",
    "deltaE00": "11.2"
    "match_percent": "93.1%",
    "more_conversions": {
        "pantone": "7649",
        "ral": "4006",
        "hks": "28",
        "rgb": "145 25 100",
        "hex": "#911964",
        "cmyk": "0 83 31 43",
        "sw": "6842",
        "ncs": "S3055-R30B",
        "hsl": "322.5 0.71 0.33",
        "lab": "33.21 53.97 -13.06"
    },
    "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	传送的原始值
to	string	传输目标格式
result	string	转换后的结果
name	string/null	Sherwin Williams 的颜色名称、NCS（德国）、HEX（如果有）、RGB（如果有）。
deltaE00	string/null	颜色之间的差异为 DeltaE2000 值 (ΔE₀₀)。有关 DeltaE 2000 或 dE₀₀ 的更多解释，请参阅下面的表格。
match_percent	string/null	在按百分比搜索匹配的制造商颜色时，请注意颜色匹配。例如match_percent':'92.2%', 仅在转换为制造商颜色时输出。
more_conversions	object	所有其他可用的并行转换数组
user_data	object	有关 API 账户的信息，如使用的转换次数。
error	string	如果出现错误：包含错误代码、描述等详细信息的对象。如果查询成功，则该字段为零或不存在

ΔE₀₀₀ 和数值的含义

ΔE₀₀	说明	人类的可感知性
< 0.5	难以察觉	人眼无法看到颜色的差异。
0.5 – 1.0	极低偏差	这种色差只有在实验室条件下才能察觉。
1.0 – 2.0	轻微偏差	色差几乎不明显，总体上可以接受。
2.0 – 3.0	可感知的偏差	直接对比就能看出色差。
3.0 – 5.0	显著偏差	色差明显，可能有问题。
> 5.0	强烈偏差	就像两种不同的颜色一样。
有关 ΔE₀₀₀、Delta E 2000 或 dE₀₀₀ 的更多信息，请点击此处。: DELTA E 2000 WIKI

⚠️ 错误代码

状态代码	意义
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, from or to" | "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

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

访客可以在颜色收集器中组合并下载颜色。免费激活 qConv Start 后，即可长期保存调色板并管理每个调色板中的颜色。

登录您的账户

或

创建账户

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

公众

取消分享

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

查看

好的，我复制了链接

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

显示调色板

关闭

创建调色板

下载以各种格式下载

全部删除

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

Gastzugang

访客访问——尚未创建 qConv Start 个人资料 基础功能可在访客额度内使用。免费创建账户后会激活 qConv Start。之后您可以将调色板和图片长期保存在个人资料中。

保存调色板：需要免费个人资料访客颜色收集器最多可添加 5 种颜色

目录

V3.0 – qConv.com 转换器 - API 文档

🔑 认证

通过 URL 参数验证

🔗 终点

📥 查询参数

支持的格式

颜色格式

+ 制造商颜色

✅ 查询示例

六角形 至 灰度

请回答：

灰度 至 制造商颜色 BEHR

请回答：

📦 响应结构

ΔE₀₀₀ 和数值的含义

⚠️ 错误代码

📈 API 限制和计费

🛠️ 应用程序接口管理器

🔒 安全

🧼 开发人员注意事项

支持

🆕 更改日志

六角形至灰度

灰度至制造商颜色 BEHR