GET
/v1/schemas/fal/chat/openrouter/router/video/enterprise
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traced9fe277eed2fa3a2de39ad0f3f6ac15e8cb340423c7d93cbff6c4cc810e27ad3{
"fetchedAt": 1790226001,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Prompt to be used for the video processing | |
| model* | string | Name of the model to use. Charged based on actual token usage. | |
| reasoning | boolean | Should reasoning be the part of the final answer. | default: false |
| enable_web_search | boolean | Give the model access to real-time web information via OpenRouter's web search server tool. When enabled, the model decides when to search and may search multiple times per request. Search costs are charged in addition to token usage. | default: false |
| video_urls | string[] | List of URLs or data URIs of video files to process. Supported formats: mp4, mpeg, mov, webm. For Google Gemini on AI Studio, YouTube links are also supported. Mutually exclusive with video_url. | nullable |
| temperature | number | This setting influences the variety in the model's responses. Lower values lead to more predictable and typical responses, while higher values encourage more diverse and less common responses. At 0, the model always gives the same response for a given input. | 0 ≤ n ≤ 2 · default: 1 |
| web_search_options | WebSearchOptions | Options for the OpenRouter ``openrouter:web_search`` server tool. | nullable |
| system_prompt | string | System prompt to provide context or instructions to the model | nullable |
| max_tokens | integer | This sets the upper limit for the number of tokens the model can generate in response. It won't produce more than this limit. The maximum value is the context length minus the prompt length. | n ≥ 1 · nullable |
Types
2 $defsWebSearchOptionsobject
Options for the OpenRouter ``openrouter:web_search`` server tool.
| search_context_size | enum | How much content to retrieve per result. For Exa: low=5K, medium=15K, high=30K characters per result; when omitted, Exa picks adaptively (~2-4K per result). Ignored with native provider search. Overridden by max_characters when both are set. | low | medium | high · nullable |
| max_results | integer | Maximum results per search call (1-25). Applies to the Exa engine; ignored with native provider search. Defaults to 5. | 1 ≤ n ≤ 25 · nullable |
| max_total_results | integer | Maximum total results across all search calls in a single request. Useful for controlling cost and context size in agentic loops. | n ≥ 1 · nullable |
| allowed_domains | string[] | Limit results to these domains. Supported by Exa and most native providers (not Google native search). | nullable |
| max_characters | integer | Exact maximum characters of content per result (1-100,000). Applies to the Exa engine; ignored with native provider search. Takes precedence over search_context_size when both are set. | 1 ≤ n ≤ 100000 · nullable |
| engine | enum | Search engine to use. 'auto' uses native provider search when available and falls back to Exa. 'native' prefers the provider's built-in web search (OpenAI, Anthropic, Google, xAI, Perplexity), falling back to Exa for models without native support. 'exa' always… | auto | native | exa · default: "auto" |
| max_uses | integer | Maximum number of searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. With native provider search, forwarded only to Anthropic; other native providers ignore it. | n ≥ 1 · nullable |
| user_location | WebSearchUserLocation | Approximate user location to bias web search results geographically. | nullable |
| excluded_domains | string[] | Exclude results from these domains. Supported by Exa and some native providers (not OpenAI or Google native search). | nullable |
WebSearchUserLocationobject
Approximate user location to bias web search results geographically.
| country | string | Two-letter country code, e.g. 'US'. | nullable |
| region | string | Region or state, e.g. 'California'. | nullable |
| city | string | City name, e.g. 'San Francisco'. | nullable |
| type | const | Location type. Only 'approximate' is supported. | "approximate" · default: "approximate" |
| timezone | string | IANA timezone, e.g. 'America/Los_Angeles'. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"openrouter/router/video/enterprise","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}