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

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

API 套餐和价格 X

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

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

🔑 认证

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

通过 URL 参数验证

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

注意:密钥采用 Base64URL 编码(与 URL 兼容),并且是安全的。

🔗 终点

GET https://qconv.com/api/v1/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/v1/convert.php?from=hex&input=FF0000&to=rgb&apikey=[您的应用程序接口密钥]

请回答:

    {
        "from": "hex",
        "input": "FF0000",
        "to": "rgb",
        "result": "255 0 0",
        "more_conversions": {
            "pantone": "185",
            "ral": "3026",
            "hks": "10",
            "rgb": "255 0 0",
            "hex": "#FF0000",
            "cmyk": "0 100 100 0",
            "sw": "2910",
            "ncs": "S1085-Y90R"
        },
        "user_data": {
            "username": "USER #12345",
            "used tokens": 1,
            "max tokens": 50,
            "percentage used": "2 %"
        }
    }
    

灰度 至 制造商颜色 BEHR

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

请回答:

    {
        "from": "rgb",
        "input": "145, 25, 100",
        "to": "behr",
        "result": "p120-7 glitterati",
        "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"
        },
        "user_data": {
            "username": "USER #12345",
            "used tokens": 2,
            "max tokens": 50,
            "percentage used": "4 %"
        }
    }
    

📦 响应结构

现场 类型 说明
from string 传输输出格式
input string 传送的原始值
to string 传输目标格式
result string 转换后的结果
match_percent string/null 在按百分比搜索匹配的制造商颜色时,请注意颜色匹配。例如match_percent':'92.2%',
仅在转换为制造商颜色时输出。
more_conversions object 所有其他可用的并行转换数组
user_data object 有关 API 账户的信息,如使用的转换次数。

⚠️ 错误代码

状态代码 意义
400 参数缺失或无效
401 无效或缺少 API 密钥
429 达到每月 API 限制
500 服务器内部错误

📈 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 个代币)。
如果您有特殊要求,我们也可以随时为您提供定制服务。请随时与我们联系。

当达到上限时:

{
        "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,0255 0 0 用于 RGB

185C185 C 适用于 PANTONE

支持

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

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

登录您的账户

创建账户

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

取消 分享

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

分享

好的,我复制了链接

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

显示调色板
关闭

创建调色板

下载以各种格式下载

全部删除

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