Supported Models

If you discover more interesting models on the official website, please contact the administrator to have them added.

Model	Description
fal-ai/flux-1/dev	Image generation
fal-ai/flux-1/dev/image-to-image	Image generation
fal-ai/flux-1/dev/redux	Image generation
fal-ai/flux-1/schnell	Image generation
fal-ai/flux-1/schnell/redux	Image generation
fal-ai/flux-pro/kontext	Image generation
fal-ai/flux-pro/kontext/max	Image generation
fal-ai/flux-pro/kontext/max/multi	Image generation
fal-ai/flux-pro/kontext/max/text-to-image	Image generation
fal-ai/flux-pro/kontext/multi	Image generation
fal-ai/flux-pro/kontext/text-to-image	Image generation

Fal-ai API Documentation

Convention
Include Authorization: Bearer your-key in the request header.
The official website uses Authorization: key your-key.
Replace the official website's https://queue.fal.run with your request domain.
The input, output, and request method are consistent with the official website.

1. Create a Task

Endpoint

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

Example

For specific request methods, please refer to the documentation for each individual model. Please note that request parameters may not take effect correctly through the relay. You can start testing from the prompt parameter. If you find that a certain parameter listed in the documentation is not working properly, you can contact customer support for assistance.

Response 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
}

Note
The response_url in the response body is the URL for the next request. You need to replace https://queue.fal.run with your relay address.

2. Retrieve Task Result

Retrieved results have an expiration time — be sure to save them.

Endpoint

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

Example

Response Body — Image

The result is 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."
}

Response Body — Video

The result is in video.

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

Retrieved results have an expiration time — be sure to save them.

Integration Tutorial

Supported Models#

Fal-ai API Documentation#

1. Create a Task#

Endpoint#

Example#

Response Body#

2. Retrieve Task Result#

Endpoint#

Example#

Response Body — Image#

Response Body — Video#

Supported Models

Fal-ai API Documentation

1. Create a Task

Endpoint

Example

Response Body

2. Retrieve Task Result

Endpoint

Example

Response Body — Image

Response Body — Video