Chuyển đổi màu API

Đổi mã màu giữa HEX, RGB, HSL, CMYK, kiểm tra độ tương phản WCAG và lấy màu bổ sung, bộ ba, tương đồng cùng các sắc độ chỉ trong một lần gọi.

GEThttps://apibox.io.vn/v1/color
Tiện ích lập trình▶ Dùng thử online

API Color nhận một màu dạng hex (#1e90ff, 1e90ff, #39f), rgb(30,144,255) hoặc hsl(210,100%,56%) và trả về đủ mọi định dạng thông dụng: hex, RGB, HSL, CMYK cùng chuỗi CSS sẵn để dán. API còn cho biết độ sáng tương đối (luminance), màu đó tối hay sáng, độ tương phản với trắng và đen, và nên dùng chữ màu gì trên nền đó.

Để phối màu, phản hồi có sẵn màu bổ sung (complementary), hai màu bộ ba (triadic), hai màu tương đồng (analogous) và tám sắc độ từ tối đến sáng (độ sáng −40 đến +40), tất cả ở dạng hex.

Truyền thêm màu thứ hai qua compare để biết tỉ lệ tương phản giữa hai màu và kết quả theo WCAG 2.x: AA cho chữ thường (≥ 4.5), AA cho chữ lớn (≥ 3) và AAA cho chữ thường (≥ 7). Rất hữu ích khi kiểm tra khả năng tiếp cận của màu thương hiệu và theme giao diện.

Tham số

TênVị tríKiểuBắt buộcMặc định
colorquerystringcóMàu dạng hex, rgb() hoặc hsl() (mã hoá # thành %23).
comparequerystringkhôngMàu thứ hai: trả về tỉ lệ tương phản và kết quả WCAG AA/AAA.

Ví dụ

curl "https://apibox.io.vn/v1/color?color=%231e90ff&compare=%23ffffff" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "hex": "#1e90ff",
  "rgb": {
    "r": 30,
    "g": 144,
    "b": 255
  },
  "hsl": {
    "h": 210,
    "s": 100,
    "l": 56
  },
  "cmyk": {
    "c": 88,
    "m": 44,
    "y": 0,
    "k": 0
  },
  "css": {
    "rgb": "rgb(30, 144, 255)",
    "hsl": "hsl(210, 100%, 56%)"
  },
  "luminance": 0.274,
  "is_dark": false,
  "contrast": {
    "white": 3.24,
    "black": 6.49,
    "best_text": "#000000"
  },
  "complementary": "#ff8f1f",
  "triadic": [
    "#ff1f8f",
    "#8fff1f"
  ],
  "analogous": [
    "#1fffff",
    "#1f1fff"
  ],
  "shades": [
    "#002952",
    "#004285",
    "#005cb8",
    "#0075eb",
    "#52a8ff",
    "#85c2ff",
    "#b8dbff",
    "#ebf5ff"
  ],
  "compare": {
    "color": "#ffffff",
    "ratio": 3.24,
    "wcag_aa_normal": false,
    "wcag_aa_large": true,
    "wcag_aaa_normal": false
  }
}

Ứng dụng

  • Đổi màu thương hiệu từ HEX sang RGB, HSL hoặc CMYK để in ấn
  • Kiểm tra cặp màu chữ/nền theo chuẩn WCAG AA, AAA
  • Tạo sắc độ và bảng màu hài hoà cho design system
  • Tự chọn màu chữ dễ đọc trên nền do người dùng chọn

Hỏi đáp

Kiểm tra độ tương phản màu WCAG thế nào?

Gọi /v1/color?color=%231e90ff&compare=%23ffffff. Đối tượng compare trả về tỉ lệ (ở đây 3.24) và kết quả đạt/không đạt AA chữ thường, AA chữ lớn, AAA chữ thường. Nhớ mã hoá dấu # thành %23 trong URL.

API nhận những định dạng màu nào?

Hex 3 hoặc 6 ký tự (có hoặc không có #), rgb()/rgba() và hsl()/hsla(). Giá trị alpha bị bỏ qua. Tên màu CSS như "red" không được endpoint này hỗ trợ.

CMYK được tính thế nào?

Theo công thức chuyển RGB→CMYK cơ bản (không dùng profile màu ICC), làm tròn đến phần trăm. Với in ấn chuyên nghiệp, hãy nhờ nhà in chuyển đổi theo profile.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →