Browse the docs
Developers / Docs / Resources
List AI models
Lists the AI Studio video and image models with their resolutions, aspect ratios, durations and credit price per generation (images: per image). Use an id as model for generate_video / generate_image.
Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.
At a glance
- REST
GET https://api.clippie.ai/v1/models
- MCP tool
list_models
- Scope
read
- Cost
- Free. Works with a read-only key.
Parameters
type- In:
- query
- Type:
- string
- Required:
- No
- Description:
- One of
video,image.
limit- In:
- query
- Type:
- integer
- Required:
- No
- Description:
- How many to return, 1-100. Default 25. 1-100.
cursor- In:
- query
- Type:
- string
- Required:
- No
- Description:
nextCursorfrom the previous page. Up to 500 chars.
Example
curl
curl "https://api.clippie.ai/v1/models?type=video" \
-H "Authorization: Bearer $CLIPPIE_API_KEY"list-models.mjs
const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };
const res = await fetch('https://api.clippie.ai/v1/models?type=video', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());Response
200 { data, nextCursor }. Pass nextCursor as cursor for the next page. The item shape is in the OpenAPI spec.
From an MCP client
Your AI calls list_models with the same fields as JSON arguments. See MCP server to connect one.
tools/call
{
"name": "list_models",
"arguments": {
"type": "video"
}
}