agentutility(7)$ man image-generate-ultra
/image-generate-ultra
PRICE / CALL
$0.22
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
uncategorized
STATUS
● live
NAME
image-generate-ultra — flagship text-to-image generation for top proprietary venice models that fit a $0.22 retail price
SYNOPSIS
POST https://x402.agentutility.ai/image-generate-ultra
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Flagship text-to-image generation for top proprietary Venice models that fit a $0.22 retail price. Tiers: 'nano-banana' (nano-banana-pro, default, Google Gemini Image 3), 'nano-banana-2' (cheaper Google variant), 'nano-banana-lite' (nano-banana-2-lite budget variant), and 'grok-sota' (grok-imagine-image-quality). Output is capped to 1024x1024 to keep wholesale within retail; for GPT Image 2 use the dedicated gpt-image endpoint. Returns a permanent fal-hosted PNG URL.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| prompt | string | Image description. Up to 5000 chars. | required |
| width | number | Output width in pixels. Range [256, 1024]. Default 1024. | optional |
| height | number | Output height in pixels. Range [256, 1024]. Default 1024. | optional |
| tier | string | Model shorthand. nano-banana=nano-banana-pro (default), nano-banana-2=nano-banana-2, nano-banana-lite=nano-banana-2-lite, grok-sota=grok-imagine-image-quality. enum: nano-banana · nano-banana-2 · nano-banana-lite · grok-sota | optional |
| model | string | Override the model. Allowed: nano-banana-pro, nano-banana-2, nano-banana-2-lite, grok-imagine-image-quality. | 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. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| image_url | string | Permanent fal-hosted PNG URL for the generated 1024x1024 image. |
| model | string | Underlying provider model ID that produced the image (e.g. nano-banana-pro, gpt-image-2, recraft-v4-pro). |
| width | number | Pixel width of the returned image, capped at 1024. |
| height | number | Pixel height of the returned image, capped at 1024. |
| tier | string | Tier slug selected for this call: nano-banana, nano-banana-2, gpt, gpt-1-5, recraft-pro, or grok-sota. |
| prompt | string | Text prompt that was sent to the underlying model. |
| seed | number | Random seed used for generation, when the provider exposes one. |
| elapsed_ms | number | Wall-clock time in milliseconds spent generating the image upstream. |
| venice_request_id | string | Upstream request ID for tracing this generation across logs. |
| source | string | Upstream provider tag (google, openai, recraft, xai) that served the request. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/image-generate-ultra \
-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-ultra tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- synthforgeimage-generationtext-to-imagenano-banana-progpt-image-2recraft-v4-progrok-imagineflagship-models
- methods
- POST
- cluster
- synthforge
- price
- $0.22 USDC per call
ADJACENT — other endpoints in synthforge
| endpoint | description | price |
|---|---|---|
| nano-banana | Generates SFW images with Venice's nano-banana-pro model on a dedicated endpoint. | $0.22 |
| ad-banner-image-expand | Expands existing images into wide, square, or portrait ad banner placements. | $0.15 |
| app-store-screenshot-expand | Expands mobile app screenshots into store, ad, and product-page layouts. | $0.15 |
| banner-image-expand | Turns existing photos into wide website, ad, and email-header canvases. | $0.15 |
| course-thumbnail-expand | Expands existing screenshots, instructor photos, or diagrams into 16:9 course thumbnails. | $0.15 |
| email-header-image-expand | Expands existing product, event, or editorial images into wide email-header canvases. | $0.15 |
| image-expand | AI image outpainting / image expansion. | $0.15 |
| linkedin-banner-expand | Expands existing photos into wide LinkedIn banner and social-profile header canvases. | $0.15 |
SEE ALSO