API Reference
生成图片
图片生成 API 端点文档
端点
POST /api/ai/nano-banana/generate从文本提示生成图片,可选使用参考图片。
请求
请求头
| 头部 | 必需 | 描述 |
|---|---|---|
Authorization | 是 | 带有 API Key 的 Bearer 令牌:Bearer sk-xxxxx |
Content-Type | 是 | application/json 或 multipart/form-data |
请求体参数
Prop
Type
支持的宽高比
| 比例 | 描述 | 使用场景 |
|---|---|---|
1:1 | 方形 | 社交媒体帖子、头像 |
2:3 | 竖版 | 手机壁纸 |
3:2 | 横版 | 摄影风格 |
3:4 | 竖版 | 产品图片 |
4:3 | 横版 | 演示文稿 |
9:16 | 竖版 | Stories、抖音、Reels |
16:9 | 宽屏 | YouTube 缩略图、桌面壁纸 |
21:9 | 超宽 | 电影风格横幅 |
响应
成功响应 (200)
{
"model": "nano-banana-2-4k",
"created": 1705123456,
"images": [
{
"url": "https://storage.example.com/generated-image.png"
}
]
}响应字段
Prop
Type
示例
基础文生图
curl -X POST https://nano-banana-pro.net/api/ai/nano-banana/generate \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "一座宁静的日本庭院,樱花盛开,锦鲤池塘,传统木桥,黄金时刻的光线",
"size": "4k",
"aspectRatio": "16:9"
}'async function generateImage() {
const response = await fetch('https://nano-banana-pro.net/api/ai/nano-banana/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: '一座宁静的日本庭院,樱花盛开,锦鲤池塘,传统木桥,黄金时刻的光线',
size: '4k',
aspectRatio: '16:9',
}),
});
if (!response.ok) {
throw new Error(`API 错误: ${response.status}`);
}
const data = await response.json();
console.log('生成的图片 URL:', data.images[0].url);
return data;
}import requests
def generate_image():
response = requests.post(
'https://nano-banana-pro.net/api/ai/nano-banana/generate',
headers={
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
json={
'prompt': '一座宁静的日本庭院,樱花盛开,锦鲤池塘,传统木桥,黄金时刻的光线',
'size': '4k',
'aspectRatio': '16:9',
}
)
response.raise_for_status()
data = response.json()
print('生成的图片 URL:', data['images'][0]['url'])
return data使用参考图片 URL 的图生图
使用参考图片来引导生成:
curl -X POST https://nano-banana-pro.net/api/ai/nano-banana/generate \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "将这张图片转换为水彩画风格",
"image": "https://example.com/my-photo.jpg",
"size": "2k"
}'const response = await fetch('https://nano-banana-pro.net/api/ai/nano-banana/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: '将这张图片转换为水彩画风格',
image: 'https://example.com/my-photo.jpg',
size: '2k',
}),
});response = requests.post(
'https://nano-banana-pro.net/api/ai/nano-banana/generate',
headers={
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
json={
'prompt': '将这张图片转换为水彩画风格',
'image': 'https://example.com/my-photo.jpg',
'size': '2k',
}
)多张参考图片
组合多张图片进行复杂的图像合成:
{
"prompt": "将这些图片组合成一个连贯的风景场景",
"image": [
"https://example.com/mountains.jpg",
"https://example.com/lake.jpg",
"https://example.com/sunset.jpg"
],
"size": "4k",
"aspectRatio": "21:9"
}上传图片(Multipart Form)
上传本地图片:
curl -X POST https://nano-banana-pro.net/api/ai/nano-banana/generate \
-H "Authorization: Bearer sk-your-api-key" \
-F "prompt=让这张照片看起来像复古胶片风格" \
-F "size=2k" \
-F "image=@/path/to/your/image.jpg"const formData = new FormData();
formData.append('prompt', '让这张照片看起来像复古胶片风格');
formData.append('size', '2k');
formData.append('image', fileInput.files[0]); // 从 input 元素获取的文件
const response = await fetch('https://nano-banana-pro.net/api/ai/nano-banana/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-your-api-key',
// 不要设置 Content-Type - 浏览器会自动设置带边界的值
},
body: formData,
});with open('/path/to/your/image.jpg', 'rb') as f:
response = requests.post(
'https://nano-banana-pro.net/api/ai/nano-banana/generate',
headers={
'Authorization': 'Bearer sk-your-api-key',
},
data={
'prompt': '让这张照片看起来像复古胶片风格',
'size': '2k',
},
files={
'image': ('image.jpg', f, 'image/jpeg'),
}
)错误响应
| 状态码 | 错误 | 描述 |
|---|---|---|
400 | Bad Request | 请求参数无效 |
401 | Unauthorized | API Key 缺失或无效 |
402 | Payment Required | 积分不足 |
500 | Internal Server Error | 生成失败 |
错误响应格式
{
"error": "描述错误的消息"
}常见错误
计划限制
| 功能 | 免费 | Standard | Pro |
|---|---|---|---|
| 最大参考图片数 | 3 | 8 | 14 |
| 并发生成数 | 1 | 5 | 10 |
| 最大图片大小 | 2.5MB | 2.5MB | 2.5MB |
| 4K 生成 | ✗ | ✓ | ✓ |
| API 访问 | ✗ | ✓ | ✓ |
