Skip to main content
POST
Submit Nano Banana Pro task

提交任务

  • Header:Authorization: Bearer <your_api_key>。
  • 必填 prompt;可选 image_urls(最多 8 张,30MB/张)、aspect_ratio、resolution、output_format。
  • 异步返回 task_id 与扣费 credits_deducted,使用 /api/v1/task/status 轮询结果。
  • Breaking:image_input 已废弃,请改用 image_urls 数组字段。
宽高比默认 1:1,运行时分辨率默认 1K,输出格式默认 png。输出格式接受 png、jpg、jpeg。当前积分档位为 1K=108、2K=108、4K=144;每次提交前都应重新读取 /pricing。

授权

Authorization
string
header
必填

Wizzx API key. This is not a JWT.

请求体

application/json
prompt
string
必填

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>
默认值:1:1
可用选项:
1:1,
9:16,
16:9,
3:4,
4:3,
3:2,
2:3,
5:4,
4:5,
21:9,
auto
resolution
enum<string>
默认值:1K
可用选项:
1K,
2K,
4K
output_format
enum<string>
默认值:png
可用选项:
png,
jpg,
jpeg

响应

Task accepted

code
enum<integer>
必填
可用选项:
0
message
string
必填
示例:

"success"

data
object
必填
request_id
string<uuid>
必填