跳转到主要内容
POST

授权

Authorization
string
header
必填

Bearer YOUR_API_KEY。在 API Keys 管理密钥。

请求体

application/json
model
string
必填

兼容旧别名 google/nano-banana-pro。

Allowed value: "nano-banana-pro"
prompt
string
必填

生成或编辑提示词。

Required string length: 1 - 20000
images
object[]

参考图;省略或传空数组为文生图。

Maximum array length: 14
resolution
enum<string>
默认值:1K

输出清晰度。

可用选项:
1K,
2K,
4K
aspect_ratio
enum<string>
默认值:1:1

支持自动比例时,可省略以适配参考图。

可用选项:
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
21:9
num
integer
默认值:1

输出数量。

必填范围: 1 <= x <= 4

响应

任务已受理。

task_id
string
必填

任务 ID,用于轮询。

model
string
必填

回显提交的模型 ID 或旧别名。

created_at
string<date-time>
必填

任务创建时间(UTC)。

request_id
string
必填

请求 ID。