agentutility(7)$ man image-generate
/image-generate
PRICE / CALL
$0.011
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
uncategorized
STATUS
● live
NAME
image-generate — turn an approved image brief into a controlled next png when an agent needs to iterate without losing the prompt setup
SYNOPSIS
POST https://x402.agentutility.ai/image-generate
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.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.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| prompt | string | Image description. Up to 2000 chars. | required |
| width | number | Output width in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024. | optional |
| height | number | Output height in pixels. Range [256, 1024], snapped to multiples of 16. Default 1024. | optional |
| tier | string | Model shorthand. Default 'fast'. enum: fast · creative · anime · sd35 | optional |
| model | string | Override the model. Must be one of: z-image-turbo, chroma, wai-Illustrious, venice-sd35. | optional |
| steps | number | Diffusion steps. Optional; depends on model. | optional |
| cfg_scale | number | Classifier-free guidance scale. Optional. | optional |
| seed | number | Random seed. Optional. | optional |
| negative_prompt | string | Negative prompt. Optional, up to 1000 characters. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| image_url | string | HTTPS URL for the generated PNG. |
| model | string | Model that produced the image. Fallback responses name fal-ai/z-image/turbo. |
| requested_model | string | Requested Venice model, present when fal.ai handled a fallback. |
| width | number | Final image width in pixels. |
| height | number | Final image height in pixels. |
| tier | string | — |
| prompt | string | Original caller prompt. |
| seed | numbernull | Seed reported by the provider, when available. |
| elapsed_ms | number | Elapsed handler time in milliseconds. |
| venice_request_id | stringnull | Venice request ID, or null for a fal.ai fallback. |
| fal_request_id | stringnull | fal.ai request ID, present when available on fallback. |
| source | string | Provider that produced the image. |
| fallback_from | string | Primary provider replaced by the fallback. |
| fallback_reason | string | Bounded reason code that triggered the fallback. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/image-generate \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the image-generate tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- image-generationtext-to-imageai-artsynthforgevenicez-image-turbochromaanimefal-ai
- env
- VENICE_API_KEY · FAL_KEY
- methods
- POST
- cluster
- synthforge
- price
- $0.011 USDC per call
ADJACENT — other endpoints in synthforge
| endpoint | description | price |
|---|---|---|
| ad-creative-image-generate | Generates ad creative images: SFW marketing visuals, concept images, and campaign thumbnails from prompts. | $0.011 |
| app-icon-image-generate | Generate app icon concepts, product marks, and launch visuals from a text prompt, ready for a mobile home screen or a SaaS dashboard. | $0.011 |
| blog-header-image-generate | Generates blog header images: SFW header images, newsletter visuals, and documentation illustrations from prompts. | $0.011 |
| book-cover-image-generate | Generates SFW book cover art concepts, genre mood boards, and launch visuals from a prompt. | $0.011 |
| brand-logo-concept-image | Generates SFW logo concept boards, abstract marks, and brand direction visuals from prompts. | $0.011 |
| course-thumbnail-image-generate | Generates SFW course thumbnails, lesson covers, learning-path artwork, and academy launch visuals, without text rendering. | $0.011 |
| ecommerce-lifestyle-image-generate | Generates SFW ecommerce lifestyle scenes and ad visuals around product prompts. | $0.011 |
| event-poster-image-generate | Generates SFW event artwork, launch posters, and campaign backgrounds without relying on stock art. | $0.011 |
SEE ALSO