Turn an approved image brief into a controlled next PNG when an agent needs to iterate wit
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.
Provider
x402.agentutility.ai · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x6c0752c09e7F6fA6526fCDf40e456a159ebB5621",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "11000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "FJqAJ4dXkFbrp3EEo8E9x98iaBGUQwaU8Srz5ePfUXLH",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "11000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"discoverable": true,
"info": {
"input": {
"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"
},
"output": {
"example": {
"elapsed_ms": 3200,
"height": 1024,
"image_url": "https://v3.fal.media/files/abc/xyz/image.png",
"model": "z-image-turbo",
"prompt": "Studio product photo of a matte black smart notebook on a warm off-white surface, soft side light, no text",
"seed": null,
"source": "venice",
"tier": "fast",
"venice_request_id": "ven_4f8a2b...",
"width": 1024
},
"type": "json"
}
},
"related": [
"/image-asset-pipeline",
"/social-image-pack",
"/image-generate-localize"
],
"schema": {
"$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"
}
},
"builder-code": {
"info": {
"a": "bc_awpbwsy3"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"a": {
"description": "App builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"s": {
"description": "Service builder codes",
"items": {
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"type": "array"
},
"w": {
"description": "Wallet builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
}
},
"type": "object"
}
}
}Use it
curl
curl "https://x402.agentutility.ai/image-generate" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://x402.agentutility.ai/image-generate");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402.agentutility.ai/image-generate")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/5209.json, and this resource appears in /discovery/resources and /discovery/search.