fal · JSON Structure

Fal Ai Structure

Core entities exchanged by the fal Model APIs, Storage API, Serverless Platform API, and dashboard.

Type: Properties: 0

Artificial IntelligenceGenerative AIGenerative MediaImage-GenerationVideo GenerationAudio GenerationInferenceServerlessGPUMCP

Fal Ai Structure is a JSON Structure definition published by fal. It conforms to the https://json-structure.github.io/draft-1/schema.json meta-schema.

Meta-schema: https://json-structure.github.io/draft-1/schema.json

JSON Structure

{
  "$schema": "https://json-structure.github.io/draft-1/schema.json",
  "$id": "https://raw.githubusercontent.com/api-evangelist/fal-ai/main/json-structure/fal-ai-structure.json",
  "title": "fal Data Structures",
  "description": "Core entities exchanged by the fal Model APIs, Storage API, Serverless Platform API, and dashboard.",
  "types": {
    "InferenceRequest": {
      "type": "object",
      "description": "Job submitted to the queue at https://queue.fal.run/{model_owner}/{model_name}.",
      "properties": {
        "model_owner": { "type": "string" },
        "model_name": { "type": "string" },
        "body": { "type": "object", "description": "Model-specific input." },
        "fal_webhook": { "type": "string", "format": "uri" },
        "sync_mode": { "type": "boolean" }
      }
    },
    "QueueAccepted": {
      "type": "object",
      "properties": {
        "request_id": { "type": "string", "format": "uuid" },
        "status": { "type": "string" },
        "status_url": { "type": "string", "format": "uri" },
        "response_url": { "type": "string", "format": "uri" },
        "cancel_url": { "type": "string", "format": "uri" }
      }
    },
    "QueueStatus": {
      "type": "object",
      "properties": {
        "status": { "type": "string", "enum": ["IN_QUEUE", "IN_PROGRESS", "COMPLETED", "FAILED", "CANCELED"] },
        "queue_position": { "type": "integer" },
        "logs": { "type": "array", "items": { "type": "object" } }
      }
    },
    "ImageOutput": {
      "type": "object",
      "properties": {
        "url": { "type": "string", "format": "uri" },
        "width": { "type": "integer" },
        "height": { "type": "integer" },
        "content_type": { "type": "string" }
      }
    },
    "VideoOutput": {
      "type": "object",
      "properties": {
        "url": { "type": "string", "format": "uri" },
        "duration": { "type": "number" },
        "fps": { "type": "number" },
        "content_type": { "type": "string" }
      }
    },
    "AudioOutput": {
      "type": "object",
      "properties": {
        "url": { "type": "string", "format": "uri" },
        "duration": { "type": "number" },
        "content_type": { "type": "string" }
      }
    },
    "UploadInitiate": {
      "type": "object",
      "properties": {
        "content_type": { "type": "string" },
        "file_name": { "type": "string" }
      }
    },
    "UploadIssued": {
      "type": "object",
      "properties": {
        "upload_url": { "type": "string", "format": "uri" },
        "file_url": { "type": "string", "format": "uri" }
      }
    },
    "ServerlessApp": {
      "type": "object",
      "properties": {
        "id": { "type": "string" },
        "name": { "type": "string" },
        "endpoint": { "type": "string", "format": "uri" },
        "gpu": { "type": "string" },
        "keep_alive": { "type": "integer" },
        "min_concurrency": { "type": "integer" },
        "max_concurrency": { "type": "integer" },
        "public": { "type": "boolean" }
      }
    },
    "Model": {
      "type": "object",
      "properties": {
        "id": { "type": "string" },
        "name": { "type": "string" },
        "category": { "type": "string", "enum": ["image", "video", "audio", "3d", "multimodal", "text"] },
        "owner": { "type": "string" },
        "price_per_output": { "type": "string" }
      }
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this

find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Structure

curl "https://apis.io/api/v1/json-structures/fal-ai-structure"

All json structure

curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.