{"uid":"cap_sBERrEP8gfKv-F7quYABV","slug":"api-x402node-dev-4836e881","name":"Image Dominant Color Extractor","description":"Extract dominant colors from an image URL via 64x64 downsample + 3-bit-per-channel quantization. Returns top N colors as hex/rgb plus frequency. Use url param (default 5, max 10). Built for AI agents picking theme colors, content categorization, brand palette extraction.","url":"https://api.x402node.dev/image/colors","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Target URL (required)"},"count":{"type":"string","description":"Count (optional)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sVkVzx3BXOkT1eirqDs4a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts the top N dominant colors from an image URL using 64x64 downsampling and 3-bit-per-channel quantization, returning hex/rgb values with frequency data.","exampleAgentPrompt":"Can you pull the top 5 dominant colors from this image — https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png — and give me the hex codes and how frequently each color appears?","exampleUseCases":[{"title":"Website theme color palette generator","prompt":"I'm redesigning my website and want to extract the main colors from our hero image so I can use them for the color scheme. Can you pull out the top 6 dominant colors and give me the hex codes so I can see what we're working with?"},{"title":"Brand logo color analysis tool","prompt":"We're updating our brand guidelines and need to know the exact color palette from our logo. Can you extract the dominant colors from this logo URL — https://example.com/logo.png — and tell me the hex values and RGB breakdowns for each?"},{"title":"E-commerce product image categorization","prompt":"Help me categorize our product images by their dominant color for our filters. Can you analyze this product photo and return the top 5 colors with their hex codes and frequency percentages so I can tag it appropriately?"}],"resultDescription":"Returns an ordered list of up to N dominant colors (default 5, max 10), each with its hex code, RGB components, and frequency/proportion within the image. Derived via 64x64 pixel downsampling and 3-bit-per-channel quantization.","failureModes":["Invalid or unreachable image URL returns an error","Unsupported image format (e.g. SVG, AVIF) may fail to decode","count parameter exceeding 10 is clamped or rejected","Very small or single-color images may return fewer colors than requested","Network timeout if the remote image URL is slow to respond"],"whenToPreferThis":"Use this endpoint when you need fast, lightweight dominant color extraction from a remote image URL without requiring a full computer vision API. Ideal for AI agents doing theme generation, brand palette extraction, or content categorization where exact pixel-perfect analysis is less important than speed and cost ($0.01 USDC per call). Prefer over heavy vision APIs when you just need the top N palette colors in hex/RGB format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:16.957Z","isFirstParty":false}