Check fal.ai Queue Request Status
fal_check_statusCheck the progress of a submitted AI generation request. Returns status (queued, in progress, completed); retrieve final output with fal_get_result when done.
Instructions
Check the status of a request previously submitted with fal_submit_request. Does NOT return the final output — once status is COMPLETED, call fal_get_result to fetch it.
Args:
model_id (string): The same model id used when submitting, e.g. "fal-ai/minimax/video-01"
request_id (string): The request_id returned by fal_submit_request
include_logs (boolean): Include runner logs (default: false)
response_format ('markdown' | 'json'): Output format (default: markdown)
Returns: Status object with fields: { "status": "IN_QUEUE" | "IN_PROGRESS" | "COMPLETED", "request_id": string, "queue_position": number, // present while IN_QUEUE "logs": array | null // present if include_logs=true }
Examples:
Use when: "Is my video ready yet?" -> check status, then fal_get_result if COMPLETED
Don't use when: you haven't submitted a request yet — use fal_submit_request first
Don't use when: you want the actual output — use fal_get_result after status is COMPLETED
Error Handling:
Returns "Not found (404)" if the request_id is wrong or the request has expired
Returns "Authentication failed" if FAL_KEY is missing or invalid
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | Yes | The fal.ai model/endpoint id, e.g. "fal-ai/flux/dev", "fal-ai/flux-pro/kontext", or "fal-ai/minimax/video-01". Find valid ids with fal_list_models or at https://fal.ai/models. | |
| request_id | Yes | The request_id returned by fal_submit_request when the job was queued. | |
| include_logs | No | Whether to include runner logs in the response (default: false) | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable (default: markdown) | markdown |