官方文档: https://fal.ai/models/fal-ai/nano-banana
POST
/fal-ai/nano-banana/fal-ai/nano-banana 文生图
API Key application/json
请求示例
curl -X POST https://top.qingyuntop.ai/fal-ai/nano-banana \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"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
}'请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
prompt | JSON body | string | 是 | 生成图片的提示词。 | - |
num_images | JSON body | integer | 否 | 生成图片数量。范围值1-4。默认值:1 | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
status | 响应 JSON | string | 是 | - | - |
request_id | 响应 JSON | string | 是 | - | - |
response_url | 响应 JSON | string | 是 | - | - |
status_url | 响应 JSON | string | 是 | - | - |
cancel_url | 响应 JSON | string | 是 | - | - |
logs | 响应 JSON | null | 是 | - | - |
metrics | 响应 JSON | object | 是 | - | - |
queue_position | 响应 JSON | integer | 是 | - | - |
响应示例
{
"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
}来源原始接口定义(用于追溯)
以下内容来自 Apifox 快照,可能包含兼容层字段或旧示例;公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899688,
"name": "/fal-ai/nano-banana 文生图",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "官方文档: https://fal.ai/models/fal-ai/nano-banana",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/fal-ai/nano-banana",
"tags": [],
"status": 1,
"requestBody": {
"type": "application/json",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "生成图片的提示词。"
},
"num_images": {
"type": "integer",
"description": "生成图片数量。范围值1-4。默认值:1"
}
},
"required": [
"prompt"
],
"x-apifox-orders": [
"prompt",
"num_images"
]
},
"examples": [
{
"mediaType": "application/json",
"value": "{\r\n \"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.\",\r\n \"num_images\": 1\r\n}"
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": []
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {
"type": "noauth"
},
"responses": [
{
"id": 114465481,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"request_id": {
"type": "string"
},
"response_url": {
"type": "string"
},
"status_url": {
"type": "string"
},
"cancel_url": {
"type": "string"
},
"logs": {
"type": "null"
},
"metrics": {
"type": "object",
"properties": {},
"x-apifox-orders": []
},
"queue_position": {
"type": "integer"
}
},
"required": [
"status",
"request_id",
"response_url",
"status_url",
"cancel_url",
"logs",
"metrics",
"queue_position"
],
"x-apifox-orders": [
"status",
"request_id",
"response_url",
"status_url",
"cancel_url",
"logs",
"metrics",
"queue_position"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 114465481,
"data": "{\r\n \"status\": \"IN_QUEUE\",\r\n \"request_id\": \"e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca\",\r\n \"response_url\": \"https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca\",\r\n \"status_url\": \"https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/status\",\r\n \"cancel_url\": \"https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/cancel\",\r\n \"logs\": null,\r\n \"metrics\": {},\r\n \"queue_position\": 0\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b1a-7586-8865-70eb503dc9b5"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436113,
"ordering": 6,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {}
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-05T14:40:24.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}