list_models
List models and their capabilities
Read the full capability envelope for the models a room can run: aspect ratios, durations, resolutions, reference capacities, which inputs a model requires, and — for voice — its complete voice roster and the languages it speaks.
Choose a model with get_benchmark; this carries everything a tool line cannot. Every model carries credits on a stated basis, cost_rank (1 = cheapest of its kind), paid_by (one of the user's own keys at no credits, house for this month's free allowance, or credits) and free_now.
Before the first use of a model in a conversation, read it alone — pass its model_id — to get its guide: how its prompt is best shaped, what it cannot combine, what it habitually gets wrong and how to prevent it, and when another model is the better call. The unfiltered listing says which models have one (has_guide) and carries no guide text.
Scope
media.read— Reads the account: media, uploads, boards, runs, Subjects, models and the balance.
Behaviour
- Read-only
- Reads the caller's own account and changes nothing.
- Stays in the account
- Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
- Idempotent
- Calling it again with the same arguments has no further effect.
Credits
What the tool's description says about credits, verbatim.
- Every model carries `credits` on a stated basis, `cost_rank` (1 = cheapest of its kind), `paid_by` (one of the user's own keys at no credits, `house` for this month's free allowance, or `credits`) and `free_now`.
Inputs
kindstring · requiredone of "image", "clip", "voice", "music", "tool"
model_idstring · optionalat most 80 characters
Example call
A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_models",
"arguments": {
"kind": "image"
}
}
}Input schema
As the server sends it in tools/list.
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"image",
"clip",
"voice",
"music",
"tool"
]
},
"model_id": {
"type": "string",
"maxLength": 80
}
},
"required": [
"kind"
],
"additionalProperties": false
}Related tools
- get_benchmark
Which model to use for a job, in three tiers (best, middle, cheapest), priced for this account: credits per reference request, who pays (`paid_by`: one of…
- generate_image
Make an image in the user's Kuro account.
- generate_clip
Start a short video clip generation.