Skip to main content
POST
Submit Nano Banana Pro task

Submit task

  • Header: Authorization: Bearer <your_api_key>.
  • Required: prompt. Optional: image_urls (max 8, 30MB each), aspect_ratio, resolution, output_format.
  • Async task_id and credits_deducted; poll /api/v1/task/status.
  • Breaking: image_input deprecated; use image_urls.
Aspect ratio defaults to 1:1; the runtime resolution default is 1K; output format defaults to png. Accepted output aliases are png, jpg, and jpeg. Current tiers are 1K=108, 2K=108, and 4K=144 credits; always re-read /pricing before submission.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json
prompt
string
required

Required prompt. The gateway enforces a 10000-byte UTF-8 limit.

Minimum string length: 1
image_urls
string<uri>[]
Maximum array length: 8

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
aspect_ratio
enum<string>
default:1:1
Available options:
1:1,
9:16,
16:9,
3:4,
4:3,
3:2,
2:3,
5:4,
4:5,
21:9,
auto
resolution
enum<string>
default:1K
Available options:
1K,
2K,
4K
output_format
enum<string>
default:png
Available options:
png,
jpg,
jpeg

Response

Task accepted

code
enum<integer>
required
Available options:
0
message
string
required
Example:

"success"

data
object
required
request_id
string<uuid>
required