Supported Models

If you find 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 https://queue.fal.run from the official website with your request domain.
Input, output, and request methods 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 when routed through the relay. You can start testing with the prompt parameter. If you find that a certain parameter documented here does not work as expected, 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 promptly.

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 promptly.

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