Skip to main content
POST
Submit Nano Banana task

Submit task

  • Header: Authorization: Bearer <your_api_key>.
  • Required: prompt (max 5000 chars). Optional: image_urls (max 10), aspect_ratio, output_format.
  • Async task_id and credits_deducted; poll /api/v1/task/status.
  • Smart mode selection based on inputs.

Image-to-image example

  • Aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto (default 1:1).
  • Credits: Fixed 24 credits per generation.
  • Output formats: png / jpeg (default png).
  • Max 10 reference images (JPEG/PNG/WebP).

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 5000-byte UTF-8 limit.

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

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
output_format
enum<string>
default:png
Available options:
png,
jpeg

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required