支持的模型

如果你在官网发觉有更多好玩的模型，请联系管理员把模型加入进来

模型 说明
fal-ai/flux-1/dev 画图
fal-ai/flux-1/dev/image-to-image 画图
fal-ai/flux-1/dev/redux 画图
fal-ai/flux-1/schnell 画图
fal-ai/flux-1/schnell/redux 画图
fal-ai/flux-pro/kontext 画图
fal-ai/flux-pro/kontext/max 画图
fal-ai/flux-pro/kontext/max/multi 画图
fal-ai/flux-pro/kontext/max/text-to-image 画图
fal-ai/flux-pro/kontext/multi 画图
fal-ai/flux-pro/kontext/text-to-image 画图

Fal-ai API 接口文档

约定
header 带上 Authorization: Bearer your-key
官网是用 Authorization: key your-key
将官网的 https://queue.fal.run 更换为 你的请求域名 输入、输出、请求方式跟官网一致

1. 生成任务

接口

POST {{BASE_URL}}/fal-ai/{{model}}

示例

curl --request POST \
  --url {{BASE_URL}}/fal-ai/flux-1/dev \
  --header 'Authorization: Bearer your-key' \
  --header 'Content-Type: application/json' \
  --data '{
     "prompt": "Extreme close-up of a single cat eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"openai-hk\" is painted over it in big, white brush strokes with visible texture."
}'

具体的请求方式请详看各个模型的文档。请注意，请求参数可能在中转中不能正确生效，你可以从prompt开始测试，如果你发现了文档中的某个参数无法正常生效，你可以联系客服进行维护。

返回体

{
  "status": "IN_QUEUE",
  "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
  "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
  "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
  "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
  "queue_position": 0
}

说明
返回体中的 response_url 为下一步请求链接，需要将 https://queue.fal.run 替换为 你的中转地址。

2. 获取任务结果

获取结果有时效，请务必保存

接口

GET {BASE_URL}/fal-ai/{modelname}/requests/{request_id}

示例

curl --request GET \
  --url {{BASE_URL}}/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324 \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json'

返回体.图片

结果在 images

{
  "images": [
    {
      "url": "https://v3.fal.media/files/rabbit/aQEmU4lEKKIIr9cDOChUB.png",
      "width": 1024,
      "height": 768,
      "content_type": "image/png"
    }
  ],
  "timings": {
    "inference": 1.2249955059960485
  },
  "seed": 920212137,
  "has_nsfw_concepts": [false],
  "prompt": "Extreme close-up of a single cat eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"openai-hk\" is painted over it in big, white brush strokes with visible texture."
}

返回体.视频

结果在 video

{
  "video": {
    "url": "https://v3.fal.media/files/lion/eSsTNfWQRXfWGim1B8ZL5_output.mp4",
    "content_type": "video/mp4",
    "file_name": "output.mp4",
    "file_size": 946834
  }
}

获取结果有时效，请务必保存