Submit a request to an endpoint path
Add a request for a model endpoint path to the queue. Use this operation when the model ID has more than two segments, for example blackforestlabs/flux-3-max/text-to-video. The response contains the request ID and the URLs for status, result, and cancellation. The queue keeps the request until a runner is available. The queue has no size limit unless you send fal_max_queue_length.
Authorizations
Send your fal API key in the Authorization header with the Key prefix, for example Authorization: Key $FAL_KEY. Public models also accept requests without a key. See Authentication.
Headers
The maximum time in seconds for the request to start on a runner. The time starts when fal receives the request and includes queue time and retries. The value must be greater than 0.1. If the request does not start in this time, the API returns 504 with X-Fal-Request-Timeout-Type: user. This header does not limit the run time on the runner. There is no default.
Set to 1, true, or yes to turn off automatic retries for this queue request. See Reliability.
1, true, yes A JSON object that sets the expiration and access rules for the files that the model creates. See Platform Headers.
Path Parameters
Query Parameters
An http or https URL. fal sends a POST request to this URL when the request completes. See Webhooks.
Body
The model input. Each model has its own input schema. See the model page in the Model API Reference.
Response
The request is in the queue.
The state of a queue request.