Skip to main content
POST
绘图

功能说明

使用启航 AI 兼容 OpenAI 的 /v1/images/generations 接口调用 nano-banana-2 生成图片。除标准 promptsize 外,还支持通过 extra_fields 传入参考图、原生分辨率和宽高比等高级参数。

支持的模型

Nano Banana 2

模型 ID: nano-banana-2Google 图像生成模型,支持参考图、多图融合、原生 2K 分辨率和 4K 超分。

Nano Banana Pro

模型 ID: nano-banana-pro适合需要更强角色一致性和复杂图像理解的场景。
查看所有绘图模型

前置条件

  • 渠道需支持图片生成能力
  • 如需返回可访问图片 URL,服务端需正确配置图片代理或上传能力
  • 模型需支持图片输出,推荐使用 nano-banana-2

基础用法

最简单的调用方式与 OpenAI Images API 保持一致:

尺寸与分辨率

除 OpenAI 标准 size 外,还支持 Nano Banana 原生分辨率值。
如果 size 不在映射表内,例如 800x600,服务端会优雅降级,由模型使用默认分辨率。

高级参数

通过 extra_fields 传入 Nano Banana 特有能力: 参数优先级如下:
  • extra_fields.image_size 优先于 size
  • extra_fields.aspect_ratio 优先于 size

使用示例

指定原生 2K 和宽高比

使用参考图 URL

使用 base64 参考图并覆盖分辨率

这里 extra_fields.image_sizeextra_fields.aspect_ratio 会覆盖 size: "1024x1024" 原本映射出的 1K1:1

多张参考图融合

返回结果

降级行为

常见错误

相关接口

绘图(Image 格式)

查看通用图片生成接口说明

改图(Image 格式)

基于原图和提示词修改图像

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
prompt
string
required

所需图像的文本描述

model
string
required

模型名称

size
string
required

生成图像的大小,格式为“长x宽”

Response

200 - application/json

成功响应

created
integer
data
object[]