{"uid":"cap_m54Hs5_wVh4XIhjgwjq5l","slug":"vextorium-image-palette-extractor-e6a2f310","name":"Vextorium Image Palette Extractor","description":"Dominant colors of an image (URL or base64) with their share, in HEX and RGB, plus the average color and light/dark tone. For brand palettes, themes or tagging images by color.","url":"https://api.vextorium.com/v1/image-palette?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string"},"colors":{"type":"integer","description":"2-16 (default 6)"},"base64_img":{"type":"string"}}},"responseSchema":{"type":"json","example":{"tone":"oscuro","colors":[{"hex":"#0d0f11","rgb":[13,15],"ratio_pct":45.38},{"hex":"#0e1916","rgb":[14,25],"ratio_pct":40.85}],"avg_color":{"hex":"#15211d","rgb":[21,33]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dJ0FnGoRYFAyJy3W7d-ur","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts dominant colors from an image (URL or base64) returning HEX/RGB values, percentage share, average color, and light/dark tone classification.","exampleAgentPrompt":"Can you extract the 8 dominant colors from this image — https://example.com/my-logo.png — and tell me their HEX codes, RGB values, percentage share, and whether the overall tone is light or dark?","exampleUseCases":[{"title":"Brand palette from logo image","prompt":"Pull the top 6 dominant colors from our logo at https://mybrand.com/logo.png and give me each one in HEX and RGB with their share percentage, so I can build our brand style guide."},{"title":"Auto-tag product photos by color","prompt":"I have a product image at https://shop.example.com/products/shirt-blue.jpg — can you extract the 4 main colors in HEX with their ratios so I can automatically tag it in our catalog?"},{"title":"Generate a UI theme from a hero image","prompt":"Analyze this hero image at https://mysite.com/hero.jpg and give me the 8 dominant colors with HEX codes and whether the image is light or dark, so I can pick matching UI colors."}],"resultDescription":"A JSON object containing: an array of dominant colors (up to 2-16) each with hex code, RGB array, and ratio_pct (percentage share); an avg_color object with hex and RGB of the overall average color; and a tone string indicating whether the image is light or dark.","failureModes":["Image URL is inaccessible or returns a non-200 response","Base64 string is malformed or not a valid image format","colors parameter outside 2-16 range causes validation error","Image too large may cause timeout or processing error","Neither url nor base64_img provided results in missing input error"],"whenToPreferThis":"Choose this endpoint when you need to programmatically extract a structured color palette from any image — either by URL or base64 — and require both HEX and RGB formats, percentage breakdowns, an average color, and light/dark tone classification. Ideal for brand palette automation, UI theme generation, image tagging pipelines, or any workflow where color data needs to feed downstream design or categorization logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T12:37:56.822Z","isFirstParty":false,"canonicalSlug":"vextorium-image-palette-extractor-e6a2f310"}