Ingyenes szín API
Színek beolvasása és átváltása, kontrasztellenőrzés, skálák és paletták készítése, színtévesztés szimulálása és design tokenek exportálása sima HTTP-n. Nincs kulcs, nincs regisztráció, JSON be és ki.
- Nincs API-kulcs és regisztráció
- GET query paraméterekkel vagy POST JSON-nel
- CORS engedélyezve, bármelyik oldalról hívható
- Ugyanaz a matematika, mint az oldalon: CSS Color 4
Végpontok
- Próbáld ki: /api/v1/parse-color?color=oklch%2862%25+0.21+260%29
Describe a color
GET, POST /api/v1/parse-colorRead any color and describe it: HEX, RGB, HSL and OKLCH values, the closest human name, the closest Tailwind class, its hue family, whether it fits sRGB and Display P3, and which text color, white or black, reads better on it.
POST törzs
curl -X POST https://pickshade.com/api/v1/parse-color \ -H 'Content-Type: application/json' \ -d '{"color":"oklch(62% 0.21 260)"}' - Próbáld ki: /api/v1/convert-color?color=%23ff5733&formats=oklch%2Chsl%2Ccmyk
Convert a color
GET, POST /api/v1/convert-colorConvert a color between formats: hex, rgb, hsl, hsv, hwb, cmyk, lab, lch, oklab, oklch, display-p3, rec2020, xyz and platform code (swiftui, uikit, flutter, android). Values follow CSS Color 4.
POST törzs
curl -X POST https://pickshade.com/api/v1/convert-color \ -H 'Content-Type: application/json' \ -d '{"color":"#ff5733","formats":["oklch","hsl","cmyk"]}' - Próbáld ki: /api/v1/find-colors?query=sage&limit=5
Find colors by name
GET, POST /api/v1/find-colorsSearch color names by words, like "sage", "dusty rose", "midnight blue" or "бордовый", and get their HEX values. Searches common names in English and Russian and about 30 000 extended color names. Use it to turn a description into real colors.
POST törzs
curl -X POST https://pickshade.com/api/v1/find-colors \ -H 'Content-Type: application/json' \ -d '{"query":"sage","limit":5}' - Próbáld ki: /api/v1/check-contrast?text=%236b7280&background=%23ffffff
Check text contrast
GET, POST /api/v1/check-contrastCheck text contrast against a background with both WCAG 2 (ratio, AA and AAA for normal and large text) and APCA (Lc value and the usage level it allows). Also suggests the nearest text color that passes AA and AAA while keeping its hue.
POST törzs
curl -X POST https://pickshade.com/api/v1/check-contrast \ -H 'Content-Type: application/json' \ -d '{"text":"#6b7280","background":"#ffffff"}' - Próbáld ki: /api/v1/fix-contrast?text=%23f97316&background=%23ffffff&target=aa&adjust=text
Fix contrast
GET, POST /api/v1/fix-contrastFind the closest color that reaches a contrast target by changing only OKLCH lightness, so the hue and character stay. Targets: aa (4.5:1), aa-large (3:1), aaa (7:1), apca-body (Lc 75), apca-content (Lc 60), apca-large (Lc 45). Adjust the text color or the background.
POST törzs
curl -X POST https://pickshade.com/api/v1/fix-contrast \ -H 'Content-Type: application/json' \ -d '{"text":"#f97316","background":"#ffffff","target":"aa","adjust":"text"}' - Próbáld ki: /api/v1/audit-palette?colors=%230f172a%2C%23f8fafc%2C%232563eb%2C%23f97316%2C%2316a34a
Audit a palette for accessibility
GET, POST /api/v1/audit-paletteCheck every text and background pair in a palette with WCAG 2 and APCA, list which pairs are safe for body text, large text or only decoration, find colors that people with color blindness cannot tell apart, and flag colors outside sRGB. Use it before shipping a theme or chart palette.
POST törzs
curl -X POST https://pickshade.com/api/v1/audit-palette \ -H 'Content-Type: application/json' \ -d '{"colors":["#0f172a","#f8fafc","#2563eb","#f97316","#16a34a"]}' - Próbáld ki: /api/v1/check-gamut?color=oklch%2870%25+0.3+145%29
Check gamut
GET, POST /api/v1/check-gamutCheck whether a color fits the sRGB, Display P3 and Rec. 2020 gamuts, and get the closest sRGB fallback that keeps lightness and hue (CSS Color 4 gamut mapping in OKLCH).
POST törzs
curl -X POST https://pickshade.com/api/v1/check-gamut \ -H 'Content-Type: application/json' \ -d '{"color":"oklch(70% 0.3 145)"}' - Próbáld ki: /api/v1/nearest-names?color=%231e3a8a&limit=3
Find color names
GET, POST /api/v1/nearest-namesFind the closest named colors, CSS color keywords and Tailwind CSS classes for a color, ranked by perceptual distance (deltaE OK).
POST törzs
curl -X POST https://pickshade.com/api/v1/nearest-names \ -H 'Content-Type: application/json' \ -d '{"color":"#1e3a8a","limit":3}' - Próbáld ki: /api/v1/compare-colors?first=teal&second=turquoise
Compare two colors
GET, POST /api/v1/compare-colorsCompare two colors: CIEDE2000 and deltaE OK difference with a plain verdict (identical, nearly, similar, different, opposite), lightness shift in percent, chroma and hue shift, and the contrast between them.
POST törzs
curl -X POST https://pickshade.com/api/v1/compare-colors \ -H 'Content-Type: application/json' \ -d '{"first":"teal","second":"turquoise"}' - Próbáld ki: /api/v1/generate-scale?color=%233b82f6
Generate a 50–950 scale
GET, POST /api/v1/generate-scaleBuild an 11-step tint and shade scale (50, 100 … 900, 950) from one color in OKLCH, the same shape as Tailwind palettes, with even perceived lightness steps.
POST törzs
curl -X POST https://pickshade.com/api/v1/generate-scale \ -H 'Content-Type: application/json' \ -d '{"color":"#3b82f6"}' - Próbáld ki: /api/v1/tints-shades?color=%232563eb&steps=5
Tints, shades and tones
GET, POST /api/v1/tints-shadesGet tints (mixed with white), shades (mixed with black) and tones (mixed with gray) of a color, evenly spaced, as HEX. Good for hover states, borders and backgrounds.
POST törzs
curl -X POST https://pickshade.com/api/v1/tints-shades \ -H 'Content-Type: application/json' \ -d '{"color":"#2563eb","steps":5}' - Próbáld ki: /api/v1/harmonies?color=%23ff5733&kind=triadic
Color harmonies
GET, POST /api/v1/harmoniesGet color harmonies for a base color, computed in OKLCH so lightness stays even: complementary, split-complementary, analogous, triadic, tetradic, square and monochromatic.
POST törzs
curl -X POST https://pickshade.com/api/v1/harmonies \ -H 'Content-Type: application/json' \ -d '{"color":"#ff5733","kind":"triadic"}' - Próbáld ki: /api/v1/mix-colors?first=%23ff5733&second=%233b82f6&amount=30&space=oklab
Mix two colors
GET, POST /api/v1/mix-colorsMix two colors at a ratio in a chosen color space, like CSS color-mix(). OKLab keeps the middle bright, sRGB tends to turn gray. Returns the result and a ready color-mix() expression.
POST törzs
curl -X POST https://pickshade.com/api/v1/mix-colors \ -H 'Content-Type: application/json' \ -d '{"first":"#ff5733","second":"#3b82f6","amount":30,"space":"oklab"}' - Próbáld ki: /api/v1/make-gradient?colors=%232563eb%2C%23f97316&kind=linear&angle=90&space=oklab
Make a CSS gradient
GET, POST /api/v1/make-gradientBuild a CSS gradient from 2 or more colors with interpolation in OKLab, OKLCH or sRGB. Returns modern CSS with the color space, a fallback with precomputed stops for older browsers, and the stop colors. OKLab avoids the gray middle that sRGB gradients get.
POST törzs
curl -X POST https://pickshade.com/api/v1/make-gradient \ -H 'Content-Type: application/json' \ -d '{"colors":["#2563eb","#f97316"],"kind":"linear","angle":90,"space":"oklab"}' - Próbáld ki: /api/v1/generate-palette?keep=%230f172a&mode=analogous&size=5&seed=brand
Generate a palette
GET, POST /api/v1/generate-paletteGenerate a harmonious palette in OKLCH. Keep colors you already have, pick a style (auto, analogous, complementary, triadic, monochromatic, pastel, vivid, muted, dark) and pass a seed to get the same palette every time.
POST törzs
curl -X POST https://pickshade.com/api/v1/generate-palette \ -H 'Content-Type: application/json' \ -d '{"keep":["#0f172a"],"mode":"analogous","size":5,"seed":"brand"}' - Próbáld ki: /api/v1/simulate-cvd?colors=%23e11d48%2C%2316a34a%2C%232563eb
Simulate color blindness
GET, POST /api/v1/simulate-cvdShow how colors look with protanopia, deuteranopia, tritanopia and achromatopsia (Machado 2009 at full severity), and list the pairs that become hard to tell apart.
POST törzs
curl -X POST https://pickshade.com/api/v1/simulate-cvd \ -H 'Content-Type: application/json' \ -d '{"colors":["#e11d48","#16a34a","#2563eb"]}' Export colors as code
POST /api/v1/export-tokensTurn a list of colors into ready code: CSS custom properties, a Tailwind v4 @theme block, SCSS variables, JSON, W3C design tokens (DTCG), a JavaScript array or an SVG swatch strip. Unnamed colors get their closest color name.
POST törzs
curl -X POST https://pickshade.com/api/v1/export-tokens \ -H 'Content-Type: application/json' \ -d '{"colors":[{"color":"#0f172a","name":"ink"},{"color":"#f97316"}],"format":"tailwind","values":"oklch"}'- Próbáld ki: /api/v1/build-system?primary=%236d4aff&format=shadcn
Build a design system
GET, POST /api/v1/build-systemBuild a full color system from a brand color: 50–950 scales for primary, secondary, accent, neutral and status colors, light and dark theme roles, exported as a Tailwind v4 theme, CSS variables, shadcn/ui globals.css or DTCG tokens, with a contrast audit of text and surface pairs.
POST törzs
curl -X POST https://pickshade.com/api/v1/build-system \ -H 'Content-Type: application/json' \ -d '{"primary":"#6d4aff","format":"shadcn"}'
Korlátok
IP-címenként másodpercenként nagyjából 10 kérés küldhető, rövid csúcsokkal. Efölött az API 429-es kóddal és Retry-After fejléccel válaszol. A soha nem változó eredményeket egy napig gyorsítótárazzuk, így az ismételt hívások azonnaliak.
Kérdések és válaszok
Kell API-kulcs?
Nem. Az API ingyenes és nyílt. Egyszerűen hívd a végpontokat HTTPS-en a szerveredről, egy szkriptből vagy a böngészőből.
Milyen színformátumokat fogad el?
Bármilyen CSS színt: HEX, rgb(), hsl(), hwb(), lab(), lch(), oklab(), oklch() és color(display-p3 …), továbbá CSS neveket, mint a navy, köznapi neveket, mint a royal blue, és Tailwind osztályokat, mint a sky-500.
Hogyan jelzi a hibákat?
A hibák application/problem+json formátumban érkeznek, egy címmel és egy leírással, amely megmondja, mit kell javítani, például ha egy szöveget nem lehet színként értelmezni.