Skip to main content
POST
Submit Nano Banana task

提交任务

  • Header:Authorization: Bearer <your_api_key>。
  • 必填 prompt(最多 5000 字符);可选 image_urls(最多 10 张)、aspect_ratio、output_format。
  • 异步返回 task_id 与扣费 credits_deducted,使用 /api/v1/task/status 轮询结果。
  • 智能模式选择,根据输入自动选择最优生成模式。

图生图示例

  • 画幅:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、auto,默认 1:1。
  • 积分:固定 24 积分/次。
  • 输出格式:png / jpeg,默认 png。
  • 最多 10 张参考图片(JPEG/PNG/WebP)。

授权

Authorization
string
header
必填

Wizzx API key. This is not a JWT.

请求体

application/json
prompt
string
必填

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>
默认值:1:1
可用选项:
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>
默认值:png
可用选项:
png,
jpeg

响应

Task accepted

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

"success"

data
object
必填
request_id
string<uuid>
必填