Turn an approved image brief into a controlled next PNG when an agent needs to i
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://x402.agentutility.ai/image-generate
| Category | Image and media |
|---|---|
| Provider host | x402.agentutility.ai |
| Networks | eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"body": {
"height": 1024,
"prompt": "Studio product photo of a matte black smart notebook on a warm off-white surface, soft side light, no text",
"seed": 481516,
"tier": "fast",
"width": 1024
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"cfg_scale": {
"description": "Classifier-free guidance scale. Optional.",
"type": "number"
},
"height": {
"description": "Output height in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024.",
"type": "number"
},
"model": {
"description": "Override the model. Must be one of: z-image-turbo, chroma, wai-Illustrious, venice-sd35.",
"type": "string"
},
"negative_prompt": {
"description": "Negative prompt. Optional, up to 1000 characters.",
"type": "string"
},
"prompt": {
"description": "Image description. Up to 2000 chars.",
"type": "string"
},
"seed": {
"description": "Random seed. Optional.",
"type": "number"
},
"steps": {
"description": "Diffusion steps. Optional; depends on model.",
"type": "number"
},
"tier": {
"description": "Model shorthand. Default 'fast'.",
"enum": [
"fast",
"creative",
"anime",
"sd35"
],
"type": "string"
},
"width": {
"description": "Output width in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024.",
"type": "number"
}
},
"required": [
"prompt"
]
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"elapsed_ms": {
"description": "Elapsed handler time in milliseconds.",
"type": "number"
},
"fal_request_id": {
"description": "fal.ai request ID, present when available on fallback.",
"type": [
"string",
"null"
]
},
"fallback_from": {
"description": "Primary provider replaced by the fallback.",
"enum": [
"venice"
],
"type": "string"
},
"fallback_reason": {
"description": "Bounded reason code that triggered the fallback.",
"type": "string"
},
"height": {
"description": "Final image height in pixels.",
"type": "number"
},
"image_url": {
"description": "HTTPS URL for the generated PNG.",
"type": "string"
},
"model": {
"description": "Model that produced the image. Fallback responses name fal-ai/z-image/turbo.",
"type": "string"
},
"prompt": {
"description": "Original caller prompt.",
"type": "string"
},
"requested_model": {
"description": "Requested Venice model, present when fal.ai handled a fallback.",
"type": "string"
},
"seed": {
"description": "Seed reported by the provider, when available.",
"type": [
"number",
"null"
]
},
"source": {
"description": "Provider that produced the image.",
"enum": [
"venice",
"fal-ai"
],
"type": "string"
},
"tier": {
"enum": [
"fast",
"creative",
"anime",
"sd35"
],
"type": "string"
},
"venice_request_id": {
"description": "Venice request ID, or null for a fal.ai fallback.",
"type": [
"string",
"null"
]
},
"width": {
"description": "Final image width in pixels.",
"type": "number"
}
},
"required": [
"image_url",
"model",
"width",
"height",
"source"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}