$ man image-generate-ultra
/image-generate-ultra(1)
PRICE / CALL
$0.30
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
uncategorized
STATUS
● live
NAME
image-generate-ultra — image generate (ultra) / flagship text-to-image / google nano-banana-pro (gemini image 3) / openai gpt-image-2 / recraft v4 pro / xai gro…
SYNOPSIS
POST https://x402.org/v1/image-generate-ultra
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Image generate (ultra) / flagship text-to-image / Google nano-banana-pro (Gemini Image 3) / OpenAI gpt-image-2 / Recraft V4 Pro / xAI Grok SOTA. Top proprietary models for the highest quality output. Tiers: 'nano-banana' (nano-banana-pro, default — Google Gemini Image 3), 'nano-banana-2' (cheaper Google variant), 'gpt' (gpt-image-2 — OpenAI flagship), 'gpt-1-5' (gpt-image-1-5), 'recraft-pro' (recraft-v4-pro), 'grok-sota' (grok-imagine-image-quality). Output is capped to 1024x1024 to keep wholesale within retail; for higher resolution, chain image-upscale. 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, gpt=gpt-image-2, gpt-1-5=gpt-image-1-5, recraft-pro=recraft-v4-pro, grok-sota=grok-imagine-image-quality. enum: nano-banana · nano-banana-2 · gpt · gpt-1-5 · recraft-pro · grok-sota | optional |
| model | string | Override the model. Allowed: nano-banana-pro, nano-banana-2, gpt-image-2, gpt-image-1-5, recraft-v4-pro, 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.org/v1/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 once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the image-generate-ultra tool to ..."
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.30 USDC per call
ADJACENT — other endpoints in synthforge
| endpoint | description | price |
|---|---|---|
| image-to-video | Image-to-video / animate still image / Seedance image-to-video / motion-from-photo / camera-movement on photo. | $0.20 |
| seedance-video | Seedance 2.0 / Seedance 2.0 video generation / Seedance video AI / generative AI video / text-to-video AI / cinematic AI clips on AI Gateway. | $0.20 |
| text-to-video | Text-to-video / AI video / Seedance / generative video / cinematic clip from prompt. | $0.20 |
| image-expand | AI image outpainting / image expansion. | $0.15 |
| image-generate-pro | Image generate (pro) / premium text-to-image / Flux 2 Pro / Recraft / Seedream / Qwen Image 2 Pro / xAI Grok Imagine. | $0.10 |
| remove-bg | AI background remover / background eraser / cutout tool. | $0.08 |
| music-generate | Music generation / text-to-music / AI music / generative song / instrumental and vocal music. | $0.05 |
| text-to-speech | Text to speech / TTS / voice generator. | $0.05 |
SEE ALSO