跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
在 Nano Banana 2 Lite 中将文字指令与最多 14 张参考图结合,探索新的场景和视觉变体。

模型

  • google/nano-banana-2-lite/edit - 使用提示词和参考图编辑图像。

功能

  • 使用提示词和参考图编辑图像。
  • image_urls 接受 1-14 张图像。

输出选项

宽高比

  • size:可选。可选值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。省略时不指定宽高比;没有默认值。不接受 auto。

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数(包括输出选项)都放在 input 内。 只发送本工作流支持的 input 字段。不支持的 input 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)、包含主机名,且不含内嵌凭证。

提示词

  • prompt:必填。描述要做的修改。最小长度:1 个字符。
  • 提供时不能为空。未规定提示词最大长度。

图像 URL

  • image_urls:必填。提供公开可访问的图像 URL。1-14 项。每项都必须是 HTTP(S) URL。

计费因素

按次计费。文生图和图像编辑使用相同的计费标准。所选宽高比(size)和参考图数量不会额外计费。 积分在提交时扣除,任务失败会退还。

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和 callback_url 放在根级。未知的根级字段会被忽略;不支持的 input 字段会被拒绝。

model
string
必填
示例:

"google/nano-banana-2-lite/edit"

input
object
必填
callback_url
string | null

可选的公开 HTTP(S) 接口,用于接收任务完成通知。建议使用 HTTPS。省略、设为 null 或空字符串即关闭回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填