Supported Models

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

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

Agreement
Include the header Authorization: Bearer your-key.
The official site uses Authorization: key your-key.
Replace https://queue.fal.run in the documentation with your request domain.
Input, output, and request methods remain consistent with the official site.

1. Create Task

Endpoint

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

Example

For specific request details, refer to each model's documentation. Please note that some parameters may not take effect during transit. You can start testing from the prompt. If you discover that a parameter in the documentation does not work properly, please contact customer support for maintenance.

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 next step request link. Replace https://queue.fal.run with your proxy address.

2. Get Task Result

Results have an expiration time; be sure to save them.

Endpoint

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

Example

Response Body - Image

Result is under 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

Result is under video.

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

Results have an expiration time; be sure to save them.

Access Tutorial

Supported Models#

Fal-ai API Documentation#

1. Create Task#

Endpoint#

Example#

Response Body#

2. Get Task Result#

Endpoint#

Example#

Response Body - Image#

Response Body - Video#

Supported Models

Fal-ai API Documentation

1. Create Task

Endpoint

Example

Response Body

2. Get Task Result

Endpoint

Example

Response Body - Image

Response Body - Video