POST
/fal-ai/nano-banana/fal-ai/nano-banana 文生图
官方文档: https://fal.ai/models/fal-ai/nano-banana
API Key application/json
Fal.ai 异步协议
调用与返回说明
Fal.ai 图片接口采用提交请求、保存 request_id、查询状态和读取结果的异步流程。创建请求成功不等于图片已经生成。
请求时注意
- 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
- 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
- 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。
返回时注意
- HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
- 创建成功后转到本协议对应的查询接口，按建议间隔轮询并设置客户端总超时。
Request
请求
/fal-ai/nano-bananaBody
必填Bodyobjectpromptstring必填生成图片的提示词。
num_imagesinteger生成图片数量。范围值1-4。默认值：1
Response返回响应
HTTP 响应返回响应 200
响应 200objectstatusstring必填request_idstring必填response_urlstring必填status_urlstring必填cancel_urlstring必填logsnull必填metricsobject必填queue_positioninteger必填Fal.ai 异步协议
调用与返回说明
Fal.ai 图片接口采用提交请求、保存 request_id、查询状态和读取结果的异步流程。创建请求成功不等于图片已经生成。
请求时注意
- 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
- 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
- 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。
返回时注意
- HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
- 创建成功后转到本协议对应的查询接口，按建议间隔轮询并设置客户端总超时。