get_models
Scope: none (any authenticated key). List available AI models with costs, limits, and input requirements. Call it when you are unsure a model or capability exists, or when comparing models — use only model_id values returned here. NARROW THE LIST, do not read all of it: the unfiltered video catalog is over 140 rows. accepts='image'|'video'|'audio'|'document' keeps only models that take that input type. duration_s= keeps only models that can render that clip length. sort='price' orders cheapest-first at that duration (default 'id'). verbose=false drops usage_notes / cost_note / estimated_time_seconds for a compact pick list. Example, animating a logo into an 8-second clip: get_models(model_type='video', accepts='image', duration_s=8, sort='price', verbose=false). PRICE: compare models on price_for, never on cost_per_generation. price_for maps duration in seconds to the COMPLETE credit cost at that length (e.g. {'8': 45} = 45 credits for an 8-second render), so price_for['8'] is directly comparable across every model, and its ABSENCE means the model cannot do 8 seconds. billing_unit ('per_second' | 'per_generation' | 'per_1000_chars' | 'per_minute') and rate give the underlying unit. cost_per_generation is legacy and NOT unit-comparable — for per-second models it is a pre-multiplied example duration that differs per family. Each model also returns: model_id, duration_range_s, estimated_time_seconds (REAL — DB-authored override or historical average of past completions; use it as the first-poll delay, do NOT poll every second), requires_input_media, input_media_types (e.g. ['image'] or ['image','video']), generation_types, capabilities (prompt_max_chars, duration_options, max_input_images, max_input_videos, supports_negative_prompt, supports_sound, video_audio), and usage_notes with exact rules. For video models, video_audio is critical: 'included' = audio in output without sound param; 'toggle_via_sound_param' = sound true/false controls audio and DEFAULTS ON, so audio is on for every supporting model unless you explicitly silence it (free on Seedance 2; Kling 2.6 and Kling 3.0 charge extra for audio but still default on, so state the higher price in your quote); 'always_on_flat_rate' = audio is always produced and the price does not change with it; 'silent' = no generated audio (Seedance 1.0). Only pass sound=false when the user explicitly asks for a silent clip. Do not answer 'which models have audio' using only supports_sound — that flag only means the sound parameter exists for toggling. latest_in_family maps a family to the CHEAPEST variant of its newest release. When requires_input_media is true, you MUST pass source_media_urls with the correct count and types to generate_media. If the user has media only on their device (no URL), use get_upload_url → user uploads at link → get_upload_session before generate_media — see those tool descriptions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_models"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | id | |
| accepts | No | ||
| verbose | No | ||
| duration_s | No | ||
| model_type | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||