{"uid":"cap_eAJruWjK3woixm5NPy7aG","slug":"x402-agentutility-ai-5cab64d0","name":"x402.agentutility.ai Image Generate (Fast/Cheap)","description":"Turn an approved image brief into a controlled next PNG when an agent needs to iterate without losing the prompt setup. Send a text prompt with optional width, height, tier, model, seed, and negative prompt; receive a hosted image URL plus the resolved model, final dimensions, prompt, seed, and timing. Venice is primary, with automatic fal.ai Z-Image Turbo failover after a definitive provider error. Keep the canvas, tier, and seed from an approved response fixed, then change one prompt detail for the next paid image pass. Choose fast for drafts, creative for campaign artwork, anime for illustration, or sd35 for Stable Diffusion-style output. Use it as an AI image generator API, repeatable text-to-image API, prompt-to-PNG API, or hosted image-production endpoint.","url":"https://x402.agentutility.ai/image-generate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["prompt"],"properties":{"seed":{"type":"number","description":"Random seed. Optional."},"tier":{"enum":["fast","creative","anime","sd35"],"type":"string","description":"Model shorthand. Default 'fast'."},"model":{"type":"string","description":"Override the model. Must be one of: z-image-turbo, chroma, wai-Illustrious, venice-sd35."},"steps":{"type":"number","description":"Diffusion steps. Optional; depends on model."},"width":{"type":"number","description":"Output width in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024."},"height":{"type":"number","description":"Output height in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024."},"prompt":{"type":"string","description":"Image description. Up to 2000 chars."},"cfg_scale":{"type":"number","description":"Classifier-free guidance scale. Optional."},"negative_prompt":{"type":"string","description":"Negative prompt. Optional, up to 1000 characters."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["image_url","model","width","height","source"],"properties":{"seed":{"type":["number","null"],"description":"Seed reported by the provider, when available."},"tier":{"enum":["fast","creative","anime","sd35"],"type":"string"},"model":{"type":"string","description":"Model that produced the image. Fallback responses name fal-ai/z-image/turbo."},"width":{"type":"number","description":"Final image width in pixels."},"height":{"type":"number","description":"Final image height in pixels."},"prompt":{"type":"string","description":"Original caller prompt."},"source":{"enum":["venice","fal-ai"],"type":"string","description":"Provider that produced the image."},"image_url":{"type":"string","description":"HTTPS URL for the generated PNG."},"elapsed_ms":{"type":"number","description":"Elapsed handler time in milliseconds."},"fallback_from":{"enum":["venice"],"type":"string","description":"Primary provider replaced by the fallback."},"fal_request_id":{"type":["string","null"],"description":"fal.ai request ID, present when available on fallback."},"fallback_reason":{"type":"string","description":"Bounded reason code that triggered the fallback."},"requested_model":{"type":"string","description":"Requested Venice model, present when fal.ai handled a fallback."},"venice_request_id":{"type":["string","null"],"description":"Venice request ID, or null for a fal.ai fallback."}}}}}}},"responseSchema":{"type":"json","example":{"seed":null,"tier":"fast","model":"z-image-turbo","width":1024,"height":1024,"prompt":"A neon-lit cyberpunk street scene, dramatic lighting, photorealistic","source":"venice","image_url":"https://v3.fal.media/files/abc/xyz/image.png","elapsed_ms":3200,"venice_request_id":"ven_4f8a2b..."}},"example":{"request":{"input":{"body":{"tier":"creative","width":1024,"height":1024,"prompt":"A serene mountain landscape with a crystal-clear lake reflecting snow-capped peaks at golden hour"},"type":"http","method":"POST","bodyType":"json"}},"response":{"seed":null,"tier":"creative","model":"chroma","width":1024,"height":1024,"prompt":"A serene mountain landscape with a crystal-clear lake reflecting snow-capped peaks at golden hour","source":"venice","image_url":"https://v3b.fal.media/files/b/0a9cdddb/SJjumKs3d8P2WmVXbiYxJ_image.png","elapsed_ms":11803,"venice_request_id":"zRgQ7I3U-xcqwC_4yuDQY8RtLl71bTyh"}},"exampleRequest":{"tier":"creative","width":1024,"height":1024,"prompt":"A serene mountain landscape with a crystal-clear lake reflecting snow-capped peaks at golden hour"},"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_fMNYTggNLqq-3pYPjQExg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a safe-for-work image from a text prompt in under 5 seconds using one of four curated AI model tiers, returning a permanent PNG URL.","exampleAgentPrompt":"Generate an image of a cozy mountain cabin at sunset with snow on the roof and warm light glowing through the windows — use the creative tier for a more artistic look.","exampleUseCases":null,"resultDescription":"A permanent fal-hosted PNG image URL pointing to the generated image, ready to embed or share.","failureModes":["Prompt violates SFW policy — generation rejected or filtered","Invalid or unrecognized model tier name — falls back to default 'fast' or returns error","Payment of $0.01 USDC not completed — request rejected","Prompt too vague or empty — low-quality or blank image returned","Upstream Venice model timeout — no URL returned within 5s window"],"whenToPreferThis":"Use this endpoint when you need a fast, cheap ($0.01) SFW image generated from text in under 5 seconds. Choose the 'fast' tier for maximum speed, 'creative' for artistic quality, 'anime' for Japanese illustration style, or 'sd35' for Stable Diffusion 3.5 output. Prefer this over the pro ($0.10) or ultra ($0.30) tiers when speed and cost matter more than top-tier photorealism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:52:29.447Z","isFirstParty":false}