支持的模型

已支持官方所有模型，以下是示例

模型	说明
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}}

示例

具体的请求方式请详看各个模型的文档。请注意，请求参数可能在中转中不能正确生效，你可以从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}

示例

返回中的 unit_price 是本次任务 fal 的消费额度，可用于计费

返回体.图片

结果在 images

{
    "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/019e06a4-3218-7ad0-b907-eae764b029ac/cancel",
    "has_nsfw_concepts": [
        false
    ],
    "images": [
        {
            "content_type": "image/jpeg",
            "height": 768,
            "url": "https://v3b.fal.media/files/b/0a995c44/saUxQYNhUY3Id6Xh9Mk-s.jpg",
            "width": 1024
        }
    ],
    "logs": null,
    "metrics": {
        "inference_time": 7.414219856262207
    },
    "prompt": "Extreme close-up of a single tiger 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 \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
    "request_id": "019e06a4-3218-7ad0-b907-eae764b029ac",
    "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/019e06a4-3218-7ad0-b907-eae764b029ac",
    "seed": 1568725547,
    "status": "COMPLETED",
    "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/019e06a4-3218-7ad0-b907-eae764b029ac/status",
    "timings": {
        "inference": 7.115621507997275
    },
    "unit_price": "0.025"
}

返回体.视频

结果在 video

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

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

接入教程

支持的模型#

Fal-ai API 接口文档#

1. 生成任务#

接口#

示例#

返回体#

2. 获取任务结果#

接口#

示例#

返回体.图片#

返回体.视频#

支持的模型

Fal-ai API 接口文档

1. 生成任务

接口

示例

返回体

2. 获取任务结果

接口

示例

返回体.图片

返回体.视频