认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头中:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: nano_banana_pro
prompt string 必需
图像生成提示词, 长度必须在 1-2500 个字符之间
提示词说明:
- 逼真场景: 对于逼真的图片, 请使用摄影术语. 提及拍摄角度、镜头类型、光线和细节, 引导模型生成逼真的效果
- 风格化插图和贴纸: 如需创建贴纸、图标或素材资源, 请明确说明样式并要求使用透明背景
- 图片中的文字准确无误: Gemini 在呈现文本方面表现出色. 清楚说明文字、字体样式（描述性）和整体设计
- 产品模型和商业摄影: 非常适合为电子商务、广告或品牌宣传拍摄清晰专业的商品照片
- 极简风格和负空间设计: 非常适合用于创建网站、演示或营销材料的背景, 以便在其中叠加文字
image_urls array
您最多可以混合使用 14 张参考图片. 这 14 张图片可以包含以下内容:
- 最多 6 张高保真对象图片, 用于包含在最终图片中
- 最多 5 张人物图片, 以保持角色一致性
aspect_ratio string
图像宽高比
可选值: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
默认情况下, 模型会使输出图片的大小与输入图片的大小保持一致, 否则会生成 1:1 的正方形
resolution string
分辨率
可选值: 1K, 2K, 4K
注意: 您必须使用大写 “K”（例如, 1K、2K、4K）. 小写参数（例如, 1k）将被拒绝
response_modalities string
默认情况下, 模型会返回文本和图片响应（即 response_modalities=[‘Text’, ‘Image’]）. 您可以使用 response_modalities=[‘Image’] 将响应配置为仅返回图片而不返回文本
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息. 仅在状态为 failed 时存在
code
integer错误代码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时存在.
content
array生成内容列表
type
string资源类型
可选值:
image,texturl
string内容 URL
usage object
使用统计信息. 仅在状态为 completed 时出现
prompt_tokens
integer提示词令牌数
completion_tokens
integer完成令牌数
total_tokens
integer总令牌数
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 005011094 | 厂商内部错误（可重试） |
| 005001095 | 内部生成错误 |
| 005001096 | 结果解析错误 |
| 005001097 | HTTP 错误响应 |
| 005001098 | 同步生成异常 |