Browse models
list_modelsList every available generation model in the catalog with its category, parameters and defaults, which params take uploaded files, and a default-request estimate labelled by price_basis (default_request, input_dependent, or duration_ceiling): cost_credits is what the call bills in whole app credits ($0.10 each), and cost_micros/cost_usd are the same amount in usd_micros and USD. Call this first to discover valid model values and how to price/shape a run call.
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": "list_models"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | set true to search the FULL sellable catalog instead of just the featured set. Results are still paged - read total and use offset | |
| limit | No | how many models to return (default 50, max 200). The catalog is over a thousand models, so page rather than fetching everything | |
| offset | No | how many matches to skip, for paging through total | |
| search | No | case-insensitive substring matched against the model name and description, e.g. "upscale" or "kling" | |
| compact | No | set true while shopping: omits each model's params and shortens its description, so a page costs a fraction of the tokens. Fetch the full entry for the one model you settle on | |
| category | No | optional category filter, e.g. text-to-image, image-to-video, text-to-speech, speech-to-text | |
| max_credits | No | filter by the displayed default-request estimate, which may be an input fallback or duration ceiling; not a run spending cap | |
| include_variable | No | with max_credits, also include input-dependent and variable-duration estimates above that budget. Their actual costs may be lower OR higher; this is discovery, not a spending guarantee. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| total | Yes | ||
| models | Yes | ||
| offset | Yes |