{"uid":"cap_aYQvQh2XrHqjr_0DDN7xG","slug":"koinelix-image-generation-8fe7afb0","name":"Koinelix Image Generation","description":"Image generation from a text prompt, with up to 3 optional reference images for editing or combining pictures. Use when an agent needs a picture: text to image, AI image generator, image edit. One image returns as Base64 JSON, usually within tens of seconds. Price: 0.021 USDC per call, paid with x402; no account or API key is needed. An optional platform API key allows up to three attempts per payment.","url":"https://api.koinelix.com/v1/images/generations?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"model":{"enum":["gpt-image-2.5","gpt-image-2.5-flare","gpt-image-2.5-sunburst"],"type":"string","maxLength":128,"minLength":1,"description":"Optional published Koinelix model ID. Omit it to use the default model (gpt-image-2.5)."},"prompt":{"type":"string","minLength":1,"description":"Text description, up to 6000 UTF-8 bytes."},"image_b64":{"type":"array","items":{"type":"string","minLength":1,"contentEncoding":"base64"},"maxItems":3,"minItems":1,"description":"Optional reference images as standard padded Base64 without a data: prefix, at most 10 MiB decoded in total. Sent after image_urls; at most 3 images in total."},"image_urls":{"type":"array","items":{"type":"string","format":"uri","maxLength":2048,"minLength":1},"maxItems":3,"minItems":1,"description":"Optional reference image URLs (http or https), passed to the model unchanged. Sent before image_b64; at most 3 images in total."}}},"responseSchema":{"type":"json","example":{"data":[{"b64_json":"<base64 image>"}],"created":1767225600,"output_format":"png"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.021","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.021/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.021","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.021","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iURxXViFoRtxf7GSCcX9y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.021","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generate a single image from a text prompt using Koinelix unified models, returned synchronously as a Base64-encoded PNG via x402 micropayment.","exampleAgentPrompt":"Generate an image of a serene Japanese zen garden at sunrise with cherry blossom petals falling gently, using the gpt-image-2.5 model.","exampleUseCases":[{"title":"AI product mockup for e-commerce","prompt":"Create an image of a minimalist white ceramic coffee mug on a marble countertop with soft morning light, using the gpt-image-2.5 model — I need it as a PNG for a product listing."},{"title":"Fantasy illustration for a story","prompt":"Generate an image of a dragon perched on a misty mountain peak at dusk, with glowing amber eyes and dark purple scales, using gpt-image-2.5-flare."},{"title":"Social media visual for a brand campaign","prompt":"Make an image of a vibrant tropical smoothie bowl topped with fresh fruit and granola, shot from overhead on a bright pastel background, using gpt-image-2.5-sunburst."}],"resultDescription":"A JSON object containing a `data` array with one element holding a `b64_json` field (Base64-encoded PNG image), plus a `created` Unix timestamp and an `output_format` field indicating 'png'.","failureModes":["Payment settled but generation failed — the payment is not refunded; resend with the same PAYMENT-SIGNATURE and body to retry","Prompt exceeds 6000 UTF-8 bytes — request rejected","Invalid or unsupported model ID provided — request rejected","Connection timeout before response arrives — keep connection open for tens of seconds; do not repay","No x402 payment header included — 402 Payment Required returned"],"whenToPreferThis":"Choose this endpoint when you need a single synchronous image generation without creating an account, want pay-per-use pricing at $0.05 USDC, and need to receive the image as Base64 JSON directly in the response. Ideal for anonymous or agent-driven workflows where account management is undesirable. Prefer it over account-based image APIs when low-friction micropayment via x402 is supported, and when you need idempotent retry via payment signature replay.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T05:40:00.754Z","isFirstParty":false,"canonicalSlug":"koinelix-image-generation-8fe7afb0"}