Supported models

If you find more interesting models on the official website, please contact the administrator to add the models

Model	Description
fal-ai/flux-1/dev	Draw
fal-ai/flux-1/dev/image-to-image	draw
fal-ai/flux-1/dev/redux	Draw
fal-ai/flux-1/schnell	Draw
fal-ai/flux-1/schnell/redux	Drawing
fal-ai/flux-pro/kontext	Drawing
fal-ai/flux-pro/kontext/max	Drawing
fal-ai/flux-pro/kontext/max/multi	Draw
fal-ai/flux-pro/kontext/max/text-to-image	draw
fal-ai/flux-pro/kontext/multi	Drawing
fal-ai/flux-pro/kontext/text-to-image	draw

#Fal-ai API interface documentation

agreement
header with Authorization: Bearer your-key
The official website uses Authorization: key your-key
Replace https://queue.fal.run on the official website with your request domain name
Input, output, and request methods are consistent with the official website

1. Generate tasks

Interface

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

Example

Please refer to the documentation of each model for specific request methods. Please note that request parameters may not take effect correctly during transfer. You can start testing from prompt. If you find that a parameter in the document does not take effect normally, you can contact customer service for maintenance.

Return body

{
  "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
}

Description
The response_url in the return body is the next request link. You need to replace https://queue.fal.run with your transit address.

2. Get task results

The results obtained are time-limited, please be sure to save them.

Interface

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

Example

Return body.picture

Results in 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."
}

Return to body.video

Results in video

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

The results obtained are time-limited, please be sure to save them.

Access tutorial

Supported models#

1. Generate tasks#

Interface#

Example#

Return body#

2. Get task results#

Interface#

Example#

Return body.picture#

Return to body.video#

Supported models

1. Generate tasks

Interface

Example

Return body

2. Get task results

Interface

Example

Return body.picture

Return to body.video