认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头中:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: nano_banana
prompt string 必需
图像生成提示词, 长度必须在 1-2500 个字符之间
提示词说明:
- 逼真场景: 对于逼真的图片, 请使用摄影术语. 提及拍摄角度、镜头类型、光线和细节, 引导模型生成逼真的效果
- 风格化插图和贴纸: 如需创建贴纸、图标或素材资源, 请明确说明样式并要求使用透明背景
- 图片中的文字准确无误: Gemini 在呈现文本方面表现出色. 清楚说明文字、字体样式（描述性）和整体设计
- 产品模型和商业摄影: 非常适合为电子商务、广告或品牌宣传拍摄清晰专业的商品照片
- 极简风格和负空间设计: 非常适合用于创建网站、演示或营销材料的背景, 以便在其中叠加文字
image_urls array
最多可接受 3 张图片作为输入
aspect_ratio string
图像宽高比
可选值: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
resolution string
图像分辨率
可选值: 1024x1024, 832x1248, 1248x832, 864x1184, 1184x864, 896x1152, 1152x896, 768x1344, 1344x768, 1536x672
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
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 005001095 | 内部生成错误 |
| 005001096 | 结果解析错误 |
| 005001097 | HTTP 错误响应 |
| 005001098 | 同步生成异常 |