青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/fal-ai/nano-banana/edit

/fal-ai/nano-banana/edit 图片编辑

官方文档: https://fal.ai/models/fal-ai/nano-banana/edit

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-banana/edit

Body

必填
Bodyapplication/json
Bodyobject
promptstring必填

图像编辑的提示词。

image_urlsarray<string>必填

需要编辑的图片url。

元素string
num_imagesinteger

生成图片数量。范围值1-4。默认值：1

Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
statusstring必填
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 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
  • 创建成功后转到本协议对应的查询接口，按建议间隔轮询并设置客户端总超时。