fal · Schema

fal Queue Inference Request

Common envelope for a request submitted to https://queue.fal.run/{model_owner}/{model_name}. The body is model-specific (additionalProperties true), but the following fields appear across most fal models.

AIArtificial IntelligenceGenerative AIGenerative MediaImage GenerationVideo GenerationAudio GenerationInferenceServerlessGPUMCP

Properties

Name Type Description
prompt string Natural-language prompt describing the desired output.
negative_prompt string Concepts the model should avoid.
image_url string Reference image URL (often https://v3.fal.media/...).
image_size object
num_inference_steps integer Number of diffusion steps.
guidance_scale number Classifier-free guidance strength.
seed integer Deterministic seed.
num_images integer
enable_safety_checker boolean
sync_mode boolean When true, request blocks until completion instead of queueing.
View JSON Schema on GitHub

JSON Schema

fal-queue-request-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/fal-ai/main/json-schema/fal-queue-request-schema.json",
  "title": "fal Queue Inference Request",
  "description": "Common envelope for a request submitted to https://queue.fal.run/{model_owner}/{model_name}. The body is model-specific (additionalProperties true), but the following fields appear across most fal models.",
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Natural-language prompt describing the desired output."
    },
    "negative_prompt": {
      "type": "string",
      "description": "Concepts the model should avoid."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Reference image URL (often https://v3.fal.media/...)."
    },
    "image_size": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "square_hd",
            "square",
            "portrait_4_3",
            "portrait_16_9",
            "landscape_4_3",
            "landscape_16_9"
          ]
        },
        {
          "type": "object",
          "properties": {
            "width": { "type": "integer", "minimum": 256, "maximum": 8192 },
            "height": { "type": "integer", "minimum": 256, "maximum": 8192 }
          }
        }
      ]
    },
    "num_inference_steps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Number of diffusion steps."
    },
    "guidance_scale": {
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "description": "Classifier-free guidance strength."
    },
    "seed": {
      "type": "integer",
      "description": "Deterministic seed."
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "enable_safety_checker": {
      "type": "boolean",
      "default": true
    },
    "sync_mode": {
      "type": "boolean",
      "description": "When true, request blocks until completion instead of queueing."
    }
  }
}