Supported Models

If you discover more interesting models on the official site, contact the admin to include them here.

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 Reference

Conventions
Include header Authorization: Bearer your-key
Official docs may use Authorization: key your-key
Replace https://queue.fal.run from the official docs with your proxy/base URL.
Input/output schema and HTTP methods follow the official spec.

1) Create a Job

Endpoint

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

Example

Refer to each model's documentation for exact request bodies. Note that some parameters may not take effect via the proxy. Start by testing with the prompt only. If you find any parameter that doesn't work as documented, contact support for maintenance.

Response

{
  "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 is the polling URL. Replace https://queue.fal.run with your proxy/base URL before requesting it.

2) Fetch Job Result

Results may expire. Save them promptly.

Endpoint

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

Example

Response: Image

The result is within the images array.

{
  "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: Video

The result is under the video key.

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

Results may expire. Save them promptly.

Access Tutorial

Supported Models#

Fal-ai API Reference#

1) Create a Job#

Endpoint#

Example#

Response#

2) Fetch Job Result#

Endpoint#

Example#

Response: Image#

Response: Video#

Supported Models

Fal-ai API Reference

1) Create a Job

Endpoint

Example

Response

2) Fetch Job Result

Endpoint

Example

Response: Image

Response: Video