颜色库
İçeriğe atla

Açık API

Beş ücretsiz uç nokta, kayıt gerekmez, anahtar gerekmez, CORS etkin. Sitedekiyle aynı veri: 24 bitlik alan, 32.258 adlandırılmış renk, 17.756 standart renk kartı ve 659 Çin geleneksel rengi.

Uç noktalara genel bakış

Her uç nokta CORS etkindir - doğrudan tarayıcıdan veya Node.js'den alın.

GET/api/search?q=crimson&limit=8Renkleri ad, standart kod, geleneksel ad veya HEX ile araGET/api/color/e63946Renk profili: 10 format + en yakın adlandırılmış renkler + 8 standart sistem eşleşmeleri + geleneksel eşleşmeler + 6 uyum + kontrastGET/api/scheme?hex=e63946&mode=triadicUyum şeması: temel renginiz etrafında altı kuralGET/api/contrast?fg=ffffff&bg=e63946Kontrast kontrolü: WCAG oranı + AA/AAA seviyeleri + en iyi metin rengiGET/api/random?count=5Özenle seçilmiş isim havuzundan rastgele renkler, en fazla 10 adet

GET/api/color/e63946

Renk profili: 10 format + en yakın adlandırılmış renkler + 8 standart sistem eşleşmeleri + geleneksel eşleşmeler + 6 uyum + kontrast

Parametreler

hexRenk değeri: 3 veya 6 hex hanesi (e63946 veya e63)

Önek istek

curl "https://www.yanseku.com/api/color/e63946"

Önek yanıt

{
  "hex": "e63946",
  "formats": {
    "rgb": { "r": 230, "g": 57, "b": 70 },
    "hsl": { "h": 355.5, "s": 77.6, "l": 56.3 },
    "hsv": { "h": 355.5, "s": 75.2, "v": 90.2 },
    "cmyk": { "c": 0, "m": 75.2, "y": 69.6, "k": 9.8 },
    "xyz": { "x": 0.352, "y": 0.2019, "z": 0.0784 },
    "lab": { "L": 52.06, "a": 65.72, "b": 34.14 },
    "oklch": { "L": 0.612, "c": 0.208, "h": 22.2 },
    "webSafe": "ff3333",
    "css": { "rgb": "rgb(230, 57, 70)", "hsl": "hsl(355.5, 77.6%, 56.3%)" }
  },
  "named": {
    "closest": { "name": "Paint the Town Red", "hex": "e63045", "deltaE": 1.34, "exact": false },
    "nearest": [ { "name": "Red Radish", "hex": "ee3344", "deltaE": 1.36, "exact": false } ]
  },
  "standards": [
    { "system": "ncs", "systemName": "NCS (Natural Color System)", "code": "NCS S 0570-Y90R", "name": "NCS S 0570-Y90R", "hex": "e6373f", "deltaE": 1.69, "exact": false },
    { "system": "munsell", "systemName": "Munsell (Re-renotation)", "code": "7.5R 6/16", "name": "7.5R 6/16", "hex": "dd3743", "deltaE": 2.02, "exact": false }
  ],
  "traditional": [
    { "name": "火红", "hex": "ff2d51", "cat": "红", "deltaE": 4.88, "exact": false },
    { "name": "银红", "hex": "f05654", "cat": "红", "deltaE": 5.89, "exact": false }
  ],
  "harmony": [
    { "type": "complementary", "colors": ["e63946", "39e6d9"] },
    { "type": "split-complementary", "colors": ["e63946", "39e683", "399de6"] }
  ],
  "contrast": {
    "onWhite": { "ratio": 4.17, "levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false } },
    "onBlack": { "ratio": 5.04, "levels": { "aaNormal": true, "aaLarge": true, "aaaNormal": false, "aaaLarge": true } },
    "bestText": "#000000"
  }
}

GET/api/scheme?hex=e63946&mode=triadic

Uyum şeması: temel renginiz etrafında altı kural

Parametreler

hexRenk değeri: 3 veya 6 hex hanesi (e63946 veya e63)
modeUyum modu, varsayılan tamamlayıcı. Seçenekler: complementary / split-complementary / triadic / tetradic / analogous / monochromatic

Önek istek

curl "https://www.yanseku.com/api/scheme?hex=e63946&mode=triadic"

Önek yanıt

{
  "hex": "e63946",
  "mode": "triadic",
  "count": 3,
  "colors": ["e63946", "46e639", "3946e6"]
}

GET/api/contrast?fg=ffffff&bg=e63946

Kontrast kontrolü: WCAG oranı + AA/AAA seviyeleri + en iyi metin rengi

Parametreler

fgÖn plan hex değeri, örn. ffffff
bgArka plan hex değeri, örn. e63946

Önek istek

curl "https://www.yanseku.com/api/contrast?fg=ffffff&bg=e63946"

Önek yanıt

{
  "fg": "ffffff",
  "bg": "e63946",
  "ratio": 4.17,
  "label": "AA Large",
  "levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false },
  "bestText": "#000000"
}

GET/api/random?count=5

Özenle seçilmiş isim havuzundan rastgele renkler, en fazla 10 adet

Parametreler

countKaç renk, 1-10 arası, varsayılan 1

Önek istek

curl "https://www.yanseku.com/api/random?count=5"

Önek yanıt

{
  "count": 3,
  "colors": [
    { "name": "Sea Foam Green", "hex": "c2e4d0" },
    { "name": "Deep Koamaru", "hex": "333366" },
    { "name": "Laser Lemon", "hex": "ffff66" }
  ]
}

Açık veri indirmeleri

API'nin ötesinde - tüm renk库 yanınızda. CSV formatı (UTF-8, başlık satırı), veri analizi, makine öğrenimi ve tasarım sistemi araştırması için hazır. Alan adları başlıkta bulunur; veri setleri her derlemede güncellenir.

color-names.csv32,258 satırlarCSV indirstandards.csv17,756 satırlarCSV indirbrands.csv3,290 satırlarCSV indirtraditional-colors.csv659 satırlarCSV indirjapanese-colors.csv184 satırlarCSV indirdesign-systems.csv2,041 satırlarCSV indirtheme-palettes.csv320 satırlarCSV indirclassic-palettes.csv508 satırlarCSV indirwide-gamut.csv4,444 satırlarCSV indircrayola.csv133 satırlarCSV indircolorbrewer.csv1,689 satırlarCSV indirart-palettes.csv674 satırlarCSV indirlego.csv111 satırlarCSV indirflags.csv690 satırlarCSV indircolormaps.csv752 satırlarCSV indirdunhuang.csv39 satırlarCSV indirskin-tones.csv18 satırlarCSV indir

Renk adları meodai/color-names (MIT) ve xkcd Color Survey'den alınmıştır; marka renkleri simple-icons açık verilerinden; Çin geleneksel renkleri zerosoul/chinese-colors ve zhongguose.com'dan alınmıştır; standart renk örneği değerleri bilgisayar tarafından simüle edilmiş dönüşümlerdir - üretim için fiziksel renk örnekleriyle doğrulayın. İlgili üst lisansları izleyin.

Açık kaynak paketler

Sitenin motoru ve verileri açık kaynak kütüphaneler olarak sunulur - çevrimdışı kullanılabilir, üretime hazır. Üç npm paketi motoru, veri setlerini ve bir MCP Sunucusunu kapsar, ayrıca bir Python portu ve bir HuggingFace veri seti bulunur.

@yanseku/color

Renk motoru: 10 format dönüşümü, CIEDE2000, APCA, OKLab karıştırma, 6 uyum kuralı, görme simülasyonu - saf matematik, sıfır bağımlılık

npm install @yanseku/color
@yanseku/data

Veri setleri: 17 korpus, 85.000'den fazla girdi (adlandırılmış renkler, standart renk örnekleri, geleneksel, Japon, markalar...), önceden hesaplanmış LAB içeren JSON

npm install @yanseku/data
@yanseku/mcp

MCP Sunucusu: tüm renk veritabanını Claude / Cursor'a bağlayın - 7 çevrimdışı araç

npm install -g @yanseku/mcp
yanseku (Python)

Python portu: pip install ile kurun ve kullanın - aynı D65 matematiği ve deltaE2000, 659 geleneksel hikaye paketlenmiş halde

pip install yanseku

MCP yapılandırması (claude_desktop_config.json)

{
  "mcpServers": {
    "yanseku": {
      "url": "https://www.yanseku.com/api/mcp"
    }
  }
}

MCP yapılandırması - yerel (npx, çevrimdışı)

{
  "mcpServers": {
    "yanseku": {
      "command": "npx",
      "args": ["-y", "@yanseku/mcp"]
    }
  }
}

Diğer renk kütüphaneleriyle yetenek karşılaştırması

Genel kütüphaneler sadece matematik yapar; Yanseku'nun benzersiz katmanı veridir: adlandırılmış renk arama, resmi renk kartı eşleştirme ve geleneksel renk hikayeleri.

YetenekYansekucolorjs.ioculorichroma-js
Renk uzayı dönüşümleri (10 format)✔✔✔
CIEDE2000 renk farkı✔✔✔
APCA algısal kontrast✔✘✘
Renk görüşü simülasyonu (8 tür)✔✘✘
Adlandırılmış renk araması (32.258)✔ 32,258✘✘
Resmi renk kartı eşleştirme (12 sistem)✔ 17,756✘✘
Çin geleneksel hikayeleri (659)✔ 659✘✘
Algısal uyum kuralları✔ 6 rules✘✔ palette
MCP Server (çevrimdışı)✔ remote + offline✘✘
Python portu✔✘✘
Tam CSV / HF Dataset✔ 17 sets✘✘

Nereden edinilir: npm (@yanseku/color · @yanseku/data · @yanseku/mcp) · PyPI (yanseku) · HuggingFace (yanseku/chinese-traditional-colors)

kaynak: standard = resmi renk kartı; community = topluluk tarafından adlandırılmış renk; traditional = Chinese traditional color

Ücretsiz genel uç nokta - lütfen makul davranın (dakikada ≤ 60 istek önerilir).