GET /v2/color-convert

颜色转换

在 HEX、RGB、CMY、CMYK、HSV、HSL 之间转换颜色。转换以 8 位 RGB 为中间表示，可能产生舍入误差。HEX 输出为带 # 前缀的大写六位颜色码；其他类型以英文逗号分隔通道，RGB 输出整数，H 保留两位小数，其余浮点通道最多保留四位小数。

Query

format string

• 默认：text
• 示例：json

value string 必填

颜色值，各通道以英文逗号分隔。HEX 支持 3 位或 6 位，可带 # 前缀；
RGB 通道为 0~255 的整数；CMY/CMYK 通道为 0~1；
HSV/HSL 的 H 为 0~360，其余通道为 0~1。

• 示例：#FF5733

input_type string 必填

输入颜色类型

• 示例：hex
• 枚举：hex rgb cmy cmyk hsv hsl

output_type string 必填

输出颜色类型

• 示例：rgb
• 枚举：hex rgb cmy cmyk hsv hsl

---

Responses

200

转换后的颜色值

Body

application/json

• data string 必填
• success boolean 必填

---

{
  "data": "string",
  "success": true
}

application/xml

• data string 必填
• success boolean 必填

---

<api>
  <data>string</data>
  <success>true</success>
</api>

text/plain

string

---

string

400

参数错误：颜色值为空，或输入/输出类型缺失或不支持

Body

application/json

• data string 必填
• error string 必填
• success boolean 必填

---

{
  "data": "string",
  "error": "string",
  "success": false
}

application/xml

• data string 必填
• error string 必填
• success boolean 必填

---

<api>
  <data>string</data>
  <error>string</error>
  <success>false</success>
</api>

text/plain

string

---

string

422

颜色值解析或转换失败

Body

application/json

• data string 必填
• error string 必填
• success boolean 必填

---

{
  "data": "string",
  "error": "string",
  "success": false
}

application/xml

• data string 必填
• error string 必填
• success boolean 必填

---

<api>
  <data>string</data>
  <error>string</error>
  <success>false</success>
</api>

text/plain

string

---

string