🎨 nano-banana 图像生成与编辑接口文档
📝 接口概述
🎯 接口一：文生图生成
基本信息
POST https://bestapi.aqi.email/fal-ai/nano-banana🔐 认证方式
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json📋 请求参数
| 参数名 | 类型 | 必需 | 说明 | 默认值 |
|---|---|---|---|---|
| prompt | string | ✅ | 生成图片的提示词（越详细越好哦！） | - |
| num_images | integer | ❌ | 生成图片数量（1-4张） | 1 |
💡 请求示例
{
"prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater.",
"num_images": 1
}🎉 响应示例
{
"status": "IN_QUEUE",
"request_id": "e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca",
"response_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca",
"status_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/status",
"cancel_url": "https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/cancel",
"logs": null,
"metrics": {},
"queue_position": 0
}✏️ 接口二：图片编辑
基本信息
POST https://bestapi.aqi.email/fal-ai/nano-banana/edit🔐 认证方式
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json📋 请求参数
| 参数名 | 类型 | 必需 | 说明 | 默认值 |
|---|---|---|---|---|
| prompt | string | ✅ | 图像编辑的提示词（描述你想要的修改效果） | - |
| image_urls | array[string] | ✅ | 需要编辑的图片URL列表 | - |
| num_images | integer | ❌ | 生成图片数量（1-4张） | 1 |
💡 请求示例
{
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
"https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
],
"num_images": 1
}🎉 响应示例
{
"status": "IN_QUEUE",
"request_id": "f8837f29-26cb-4213-90f5-22b2911a0ea7",
"response_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7",
"status_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/status",
"cancel_url": "https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/cancel",
"logs": null,
"metrics": {},
"queue_position": 0
}📊 响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| status | string | 任务状态（IN_QUEUE: 排队中） |
| request_id | string | 请求唯一标识符 |
| response_url | string | 获取结果的URL |
| status_url | string | 查询状态的URL |
| cancel_url | string | 取消任务的URL |
| queue_position | integer | 队列位置 |
🚀 完整调用示例
文生图调用
图片编辑调用
💡 使用小贴士
1.
2.
3.
status_url 查询处理进度4.
❓ 常见问题
A: 通常在几秒到几分钟不等，具体取决于队列情况和图片复杂度 ⏱️
A: 可以！
num_images 参数支持1-4张图片同时生成 🎨A: 通过响应中的
response_url 获取最终结果 📥修改于 2025-09-02 05:54:17