模型名称#
| 字段 | 值 |
|---|
| 模型名称 | nano-banana |
| 推荐场景 | 轻量图片生成、快速改图和社媒配图 |
| 接口类型 | 文生图 / 图像编辑 / 参考图生成 |
文生图 API#
用于根据文本提示词生成图片，适合海报、插画、商品图、社媒配图和创意草图。请求地址#
POST https://yesapi.online/v1/images/generations请求参数#
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
model | string | 是 | - | 固定值：nano-banana |
prompt | string | 是 | - | 图片生成提示词，建议包含主体、场景、风格、光线、构图和细节要求 |
n | integer | 否 | 1 | 生成图片数量 |
size | string | 否 | 1024x1024 | 输出尺寸，如 1024x1024、1024x1536、1536x1024 |
response_format | string | 否 | url | url 或 b64_json |
seed | integer | 否 | - | 固定随机种子，便于复现相近构图 |
negative_prompt | string | 否 | - | 不希望出现在图像中的内容 |
请求示例#
图片编辑 API#
用于根据输入图片和编辑指令生成新图片，适合商品图换背景、局部重绘、主体保持、风格迁移和参考图合成。请求地址#
POST https://yesapi.online/v1/images/edits请求参数#
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
model | string | 是 | - | 固定值：nano-banana |
prompt | string | 是 | - | 编辑指令，建议明确说明保留主体、修改区域和输出风格 |
image_url | string | 是 | - | 输入图片 URL，需可公网访问 |
mask_url | string | 否 | - | 局部编辑遮罩图 URL，白色区域表示需要编辑的区域 |
size | string | 否 | 1024x1024 | 输出尺寸，如 1024x1024、1024x1536、1536x1024 |
response_format | string | 否 | url | url 或 b64_json |
请求示例#
响应示例#
{
"created": 1784534400,
"data": [
{
"url": "https://yesapi.online/v1/images/cache/nano-banana_example.png"
}
]
}
响应字段#
| 字段 | 类型 | 说明 |
|---|
created | integer | 请求创建时间戳 |
data | array | 图片结果列表 |
data[].url | string | 当 response_format=url 时返回的图片地址 |
data[].b64_json | string | 当 response_format=b64_json 时返回的 Base64 图片数据 |
Python SDK 示例#
Node.js SDK 示例#
错误码#
| HTTP 状态码 | 错误类型 | 排查建议 |
|---|
400 | Invalid request | 检查 model、prompt、size、图片 URL 和参数格式 |
401 | Unauthorized | 检查 API Key 是否正确，Header 是否为 Authorization: Bearer sk-... |
402 | Insufficient balance | 检查账户余额、套餐额度或充值状态 |
413 | Payload too large | 压缩输入图片，或改用图片 URL 方式提交 |
429 | Rate limited | 降 低并发、增加重试间隔，或升级额度 |
500 | Upstream error | 稍后重试；如持续失败，记录请求参数并联系 YesAPI 支持 |
最佳实践#
提示词尽量包含主体、背景、风格、镜头、光线、比例和质量要求。
电商图建议明确“保留商品主体、真实阴影、干净背景、不要改变 Logo 和文字”。
批量生成时建议保存请求参数、返回 URL、业务 ID，便于追踪和复现。
需要低成本批量调用时，可结合 YesAPI.online 的充值入口、优惠码和活动折扣，形成双重折扣。
相关链接#
Modified at 2026-07-21 13:31:56
