获取 API Key 获取 API
文档

Nano banana Pro 图像生成

- 异步处理模式,返回任务ID用于后续查询

  • 高质量图像生成,专业级图像创建
  • 生成的图像链接,有效期为24小时,请尽快保存
信息

模型名兼容提示:本接口同时兼容别名 nano-banana-pro-ext(等价于 gemini-3-pro-image-preview)、nano-banana-pro(等价于 gemini-3-pro-image-preview-official),别名与主名可互换使用、效果一致。

请求示例

# model 可填 "gemini-3-pro-image-preview",也兼容别名 "nano-banana-pro-ext"
curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "月光下的竹林小径",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

model string

图像生成模型名称

支持的模型:

  • gemini-3-pro-image-preview - 标准版本(兼容别名 nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official - 官方版本(兼容别名 nano-banana-pro)

示例:"gemini-3-pro-image-preview" 或 "gemini-3-pro-image-preview-official"

注意



为兼容旧版调用,别名 nano-banana-pro-ext(对应 gemini-3-pro-image-preview)、nano-banana-pro(对应 gemini-3-pro-image-preview-official)仍可正常使用。

prompt string

图像生成的文本描述

size string

图像生成的尺寸

支持的格式:

  • 比例:auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9

警告



文生图 size 为 auto 时默认 1:1 或 16:9;图生图按上游返回比例为准。(建议指定比例)

n integer

生成图像的数量

取值范围:1

默认值:1

⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错

resolution string

输出图像分辨率

支持的值:

  • 1K - 1K 分辨率(默认)
  • 2K - 2K 分辨率
  • 4K - 4K 分辨率

⚠️ 注意: 使用 base64 格式生成 4K 图像时,处理时间会较长

official_fallback boolean

是否使用官方渠道兜底

  • false:不使用(默认)
  • true:使用官方渠道

警告



当使用官方渠道(gemini-3-pro-image-preview-official)时,不能使用此参数。

image_urls array

参考图像的 URL 列表,用于图生图或图像编辑

💡 快速填写(Try it 区域):

  1. 点击 "+ Add an item" 添加一个图像URL
  2. 输入图像的完整 URL 地址或base64数据

    数组中的每个元素为字符串,支持两种格式:

    1. 完整的图像URL地址

    • 公开可访问的图像URL(http\:// 或 https\://)
    • 示例:"https://example.com/image.jpg"

    2. Base64 编码格式

    • 必须使用完整的 Data URI 格式
    • 格式:data:image/{格式};base64,{base64数据}
    • 支持的图片格式:jpeg、png、webp 等
    • 示例:"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg..."
    • ⚠️ 注意:必须包含 data:image/jpeg;base64, 前缀部分

    限制:

    • 单张图片不超过 10MB
    • 支持格式:.jpeg、.jpg、.png、.webp

限制: 最多 14 张图片

Response

code integer

响应状态码

data array
返回数据数组
status string

任务状态

  * submitted - 已提交
task_id string

任务唯一标识符