Skip to main content
POST
中国大陆用户请注意: 请使用 https://toapis.cn 作为 Base URL. 将以下示例中的 https://toapis.com 替换为 https://toapis.cn.

模型选择

两个模型使用相同的接口和请求参数, 仅通过 model 字段切换. 支持文生图和图生图. 请求异步执行, 提交成功后通过任务 ID 查询结果.
image_urls 只接收公开可访问的图片 URL, 不接收 base64 数据. 请先使用 上传图片接口 上传本地图片并获取 URL.

认证

string
必填
所有请求均需要 Bearer Token. 请在 API Key 管理页面 获取 API Key.

请求参数

string
默认值:"gemini-nano-banana-2.1"
必填
模型名称. 使用 gemini-nano-banana-2.1 或 gemini-nano-banana-2.1-vip.
string
必填
图像生成或编辑的文本描述.
string
输出图像的宽高比. 支持以下值:
  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1:8, 8:1
integer
默认值:1
输出数量固定为数字 1, 不要使用字符串 "1".
string[]
参考图片 URL 字符串数组, 用于图生图或图像编辑. 最多 14 张图片, 每个 URL 必须公开可访问. 参考图数量不代表输出图片数量.单张图片不超过 10MB. 支持 .jpeg, .jpg, .png, .webp.
object
额外配置参数.

响应字段

string
任务 ID, 用于查询任务状态和结果.
string
固定为 generation.task.
string
请求中使用的模型 ID.
string
任务状态: queued, in_progress, completed, failed.
integer
任务进度百分比, 范围为 0-100.
integer
任务创建时间, Unix 时间戳, 单位为秒.
object
任务元数据.

查询结果

提交响应中的 id 是任务 ID. 使用 图片任务查询接口 获取任务状态和最终图片. 异步通知请参考 Webhook 回调.