pick_model
Scope: none (any authenticated key). Resolve ONE model for a job, with priced alternates and the reason anything was excluded. PREFER THIS over reading the whole get_models catalog when you are choosing a model: the video catalog alone is 141 rows, and comparing them by eye is how a job lands on a model that costs several times what an equally capable one does. Describe the job, not a model: modality, how many images / videos / audios you will attach, duration_s, spoken_language, wants_recurring_character, nsfw, aspect_ratio. DESCRIBE THE INPUTS HONESTLY - pass images=1 when the user attached one image. A wrong count returns a model that cannot take the file, and the attachment gets ignored. Returns primary (the QUALITY pick for that lane), alternates led by the CHEAPEST capable model with its price, rejected naming what could not do the job and why, and cheaper_option when the cheap route is materially less than the primary - say BOTH numbers in your plan card when it is. tier='cheapest' inverts it and returns the cheapest capable model as primary; tier='quality' is the default behaviour stated explicitly. If the user NAMED a model, pass it as user_named_model: it is returned verbatim with its price and a capability_warning if the inputs do not fit. This tool NEVER substitutes a different family or tier for a model the user asked for. A spoken name ('treblo', 'kling 4 flash') that matches exactly ONE id resolves to it and says so in resolved_from; one that matches several returns did_you_mean, so ask. This does not generate anything and costs no credits; follow it with estimate and generate_media.
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": "pick_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nsfw | No | ||
| tier | No | value | |
| audios | No | ||
| images | No | ||
| videos | No | ||
| modality | No | video | |
| documents | No | ||
| duration_s | No | ||
| aspect_ratio | No | ||
| spoken_language | No | none | |
| user_named_model | No | ||
| wants_recurring_character | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||