List Models
GET
https://api.youvico.com/api/ai/models- MCP Tool
- Not Supported
- Rate Limit
- Default
- Scope
- ai:generate
Returns the output types and models that Generate File accepts, with a settings schema for each generation mode.
The example shows only some models.
Example
curl 'https://api.youvico.com/api/ai/models' \
-H 'Authorization: Bearer YOUR_API_KEY'
{
"data": [
{
"outputType": "PDF",
"models": [
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"provider": "ANTHROPIC",
"configs": {
"ADVANCED": {
"x-maxAttachments": 20,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"references": {
"type": "array",
"items": { "type": "string" },
"maxItems": 20,
"uniqueItems": true,
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp", "image/avif", "image/gif", "application/pdf", "text/plain", "text/markdown", "text/csv"],
"x-maxSize": {
"image/gif": 5000000,
"image/": 50000000,
"application/pdf": 50000000,
"text/": 5000000
}
},
"effort": {
"type": "string",
"enum": ["low", "medium", "high", "xhigh", "max"],
"default": "medium"
}
},
"additionalProperties": false
}
}
}
]
},
{
"outputType": "IMAGE",
"models": [
{
"id": "gemini-3.1-flash-image",
"name": "Nano Banana 2",
"provider": "GOOGLE",
"configs": {
"AUTO": {
"x-maxAttachments": 5,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"aspectRatio": {
"type": "string",
"enum": ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "adaptive"],
"default": "16:9"
},
"resolution": {
"type": "string",
"enum": ["0.5k", "1k", "2k", "4k"],
"default": "2k"
},
"effort": {
"type": "string",
"enum": ["low", "high"],
"default": "low"
}
},
"additionalProperties": false
},
"ADVANCED": {
"x-maxAttachments": 10,
"x-maxPromptLength": 16000,
"type": "object",
"properties": {
"references": {
"type": "array",
"items": { "type": "string" },
"maxItems": 10,
"uniqueItems": true,
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp"],
"x-maxSize": 50000000
},
"aspectRatio": {
"type": "string",
"enum": ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "adaptive"],
"default": "16:9"
},
"resolution": {
"type": "string",
"enum": ["0.5k", "1k", "2k", "4k"],
"default": "2k"
},
"effort": {
"type": "string",
"enum": ["low", "high"],
"default": "low"
}
},
"additionalProperties": false
}
}
}
]
},
{
"outputType": "VIDEO",
"models": [
{
"id": "kling-3.0-turbo",
"name": "Kling 3.0 Turbo",
"provider": "KUAISHOU",
"configs": {
"AUTO": {
"x-maxAttachments": 5,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"resolution": {
"type": "string",
"enum": ["720p", "1080p"],
"default": "720p"
},
"durationSeconds": {
"type": "integer",
"enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"default": 5
},
"aspectRatio": {
"type": "string",
"enum": ["16:9", "9:16", "1:1"],
"default": "16:9"
}
},
"additionalProperties": false
},
"ADVANCED": {
"x-maxAttachments": 1,
"x-maxPromptLength": 2500,
"type": "object",
"properties": {
"resolution": {
"type": "string",
"enum": ["720p", "1080p"],
"default": "720p"
},
"durationSeconds": {
"type": "integer",
"enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"default": 5
},
"aspectRatio": {
"type": "string",
"enum": ["16:9", "9:16", "1:1"],
"default": "16:9"
},
"start": {
"type": "string",
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp"],
"x-maxSize": 10000000
},
"shots": {
"type": "array",
"minItems": 2,
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"prompt": { "type": "string", "minLength": 1, "maxLength": 512 },
"seconds": { "type": "integer", "minimum": 1 }
},
"required": ["prompt", "seconds"],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
}
]
}
]
}
Request
curl -X GET 'https://api.youvico.com/api/ai/models' \
-H 'Authorization: Bearer YOUR_API_KEY'
Response200 OK
{
"data": [
{
"outputType": "PDF",
"models": [
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"provider": "ANTHROPIC",
"configs": {
"ADVANCED": {
"x-maxAttachments": 20,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"references": {
"type": "array",
"items": { "type": "string" },
"maxItems": 20,
"uniqueItems": true,
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp", "image/avif", "image/gif", "application/pdf", "text/plain", "text/markdown", "text/csv"],
"x-maxSize": {
"image/gif": 5000000,
"image/": 50000000,
"application/pdf": 50000000,
"text/": 5000000
}
},
"effort": {
"type": "string",
"enum": ["low", "medium", "high", "xhigh", "max"],
"default": "medium"
}
},
"additionalProperties": false
}
}
}
]
},
{
"outputType": "IMAGE",
"models": [
{
"id": "gemini-3.1-flash-image",
"name": "Nano Banana 2",
"provider": "GOOGLE",
"configs": {
"AUTO": {
"x-maxAttachments": 5,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"aspectRatio": {
"type": "string",
"enum": ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "adaptive"],
"default": "16:9"
},
"resolution": {
"type": "string",
"enum": ["0.5k", "1k", "2k", "4k"],
"default": "2k"
},
"effort": {
"type": "string",
"enum": ["low", "high"],
"default": "low"
}
},
"additionalProperties": false
},
"ADVANCED": {
"x-maxAttachments": 10,
"x-maxPromptLength": 16000,
"type": "object",
"properties": {
"references": {
"type": "array",
"items": { "type": "string" },
"maxItems": 10,
"uniqueItems": true,
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp"],
"x-maxSize": 50000000
},
"aspectRatio": {
"type": "string",
"enum": ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "adaptive"],
"default": "16:9"
},
"resolution": {
"type": "string",
"enum": ["0.5k", "1k", "2k", "4k"],
"default": "2k"
},
"effort": {
"type": "string",
"enum": ["low", "high"],
"default": "low"
}
},
"additionalProperties": false
}
}
}
]
},
{
"outputType": "VIDEO",
"models": [
{
"id": "kling-3.0-turbo",
"name": "Kling 3.0 Turbo",
"provider": "KUAISHOU",
"configs": {
"AUTO": {
"x-maxAttachments": 5,
"x-maxPromptLength": 5000,
"type": "object",
"properties": {
"resolution": {
"type": "string",
"enum": ["720p", "1080p"],
"default": "720p"
},
"durationSeconds": {
"type": "integer",
"enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"default": 5
},
"aspectRatio": {
"type": "string",
"enum": ["16:9", "9:16", "1:1"],
"default": "16:9"
}
},
"additionalProperties": false
},
"ADVANCED": {
"x-maxAttachments": 1,
"x-maxPromptLength": 2500,
"type": "object",
"properties": {
"resolution": {
"type": "string",
"enum": ["720p", "1080p"],
"default": "720p"
},
"durationSeconds": {
"type": "integer",
"enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"default": 5
},
"aspectRatio": {
"type": "string",
"enum": ["16:9", "9:16", "1:1"],
"default": "16:9"
},
"start": {
"type": "string",
"x-mimeTypes": ["image/jpeg", "image/png", "image/webp"],
"x-maxSize": 10000000
},
"shots": {
"type": "array",
"minItems": 2,
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"prompt": { "type": "string", "minLength": 1, "maxLength": 512 },
"seconds": { "type": "integer", "minimum": 1 }
},
"required": ["prompt", "seconds"],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
}
]
}
]
}
Request
No parameters.
Response
Returns 200 OK.
dataarrayModels grouped by output type
data[].outputTypestringOutput type
Possible values: PDFMARKDOWNIMAGEVIDEO3DMUSIC
Example: IMAGE
data[].modelsarrayModels for the output type
Settings Schema
configs.AUTO and configs.ADVANCED are JSON Schema 2020-12 objects. Each property's enum and default give its accepted values and default. ADVANCED schemas also include attachment slots and the rules between them.
| Extension keyword | Description |
|---|---|
x-maxAttachments | Total attachments one request accepts |
x-maxPromptLength | Maximum prompt length in characters for the mode |
x-mimeTypes | MIME types an attachment slot accepts |
x-maxSize | Maximum attachment size in bytes. When limits differ by type, an object keyed by MIME type prefix. The first key that matches applies; more specific keys come first, so the longest matching prefix wins. The MIME type must match one of the keys |
x-acceptsYoutube | When true, the slot also accepts YouTube files |