> ## Documentation Index
> Fetch the complete documentation index at: https://docs.protoface.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Models
> Fields, operations, and request schemas for every model.
`GET /v1/models` is the live contract for every model: operations,
request schemas, accepted and returned media, and availability. It
changes as models are added and retired, so read it at runtime rather
than pinning a fixed list. A model's
`id` is `publisher/model`, which is also the path for
`POST /v1/run/{model_id}`.
## List models
```bash theme={null}
curl https://api.protoface.com/v1/models \
-H "Authorization: Bearer $PROTOFACE_API_KEY"
```
Each object in `data` is one model's contract.
| Field | Meaning |
| - | - |
| `id` | Value for `POST /v1/run/{model_id}` |
| `owner` | Publisher, which is also the first half of the ID |
| `display_name` / `description` | Human-readable label and summary |
| `family` | Groups revisions of the same model |
| `aliases` | Other IDs that resolve to this model |
| `tags` | Free-form labels such as `video`, `generation`, `self-hosted` |
| `operations` | Each operation with its input roles and parameter names |
| `request_schemas` | JSON Schema per operation, where the model publishes one |
| `input_modalities` / `output_modalities` | Media accepted and returned |
| `execution_modes` | How the model runs |
| `execution_targets` | `shared`, or `dedicated` where capacity can be reserved |
| `pricing` | How the model meters, detailed under [Metering](#metering) |
| `available` | Whether the model is accepting runs |
| `revision` / `contract_revision` | Model version and contract version |
| `output_quality_descriptions` | Notes on quality tiers, where the model provides them |
A model with `available` set to `false` rejects runs before any credits
are reserved, returning `error.code: "model.not_available"`.
## Filter by what a model produces
Filter on `output_modalities`, whose values are `video`, `image`,
`audio`, and `model.3d`.
```bash theme={null}
curl -s https://api.protoface.com/v1/models \
-H "Authorization: Bearer $PROTOFACE_API_KEY" \
| jq -r '.data[] | select(.output_modalities | contains(["video"])) | .id'
```
A model that returns more than one kind of file matches more than one of
these filters.
## Retrieve one model
```bash theme={null}
curl https://api.protoface.com/v1/models/minimax/minimax-h3 \
-H "Authorization: Bearer $PROTOFACE_API_KEY"
```
Retrieving one model returns the same fields as its list entry.
`operations` and `request_schemas` define the request.
### Operations
`operations` is keyed by operation name. Each declares its media inputs
as roles, its parameter names, and any dependencies between roles.
```json theme={null}
{
"operations": {
"video.general": {
"required_input_roles": ["prompt"],
"input_roles": {
"prompt": { "types": ["text"], "modalities": ["text"] },
"first_frame": { "types": ["asset"], "modalities": ["image"], "max_count": 1 },
"last_frame": { "types": ["asset"], "modalities": ["image"], "max_count": 1 },
"reference": { "types": ["asset"], "modalities": ["image"], "max_count": 9 }
},
"parameter_names": ["aspect_ratio", "duration_seconds", "generate_audio", "quality", "style"],
"role_dependencies": { "last_frame": ["first_frame"] },
"output_modalities": ["video"]
}
}
}
```
Violating `role_dependencies` returns
`error.code: "run.input_role_dependency"`. Here `last_frame` requires
`first_frame`. A combination the model will not accept returns
`error.code: "run.input_role_conflict"`, naming the fields involved.
A model with several operations requires `operation` on every request.
Omitting it returns `error.code: "run.operation_required"` with the valid
names.
### Request schemas
`request_schemas` holds the JSON Schema for each operation, covering
types, enums, defaults, and bounds. `additionalProperties` is `false`, so
an unrecognized field is rejected rather than ignored.
```json theme={null}
{
"request_schemas": {
"video.general": {
"type": "object",
"additionalProperties": false,
"required": ["prompt"],
"properties": {
"prompt": { "type": "string" },
"duration_seconds": { "type": "integer", "minimum": 4, "maximum": 15, "default": 8 },
"quality": { "type": "string", "enum": ["480p", "768p", "2k"], "default": "480p" },
"first_frame": { "type": "string", "description": "A public URL, a data URI, or an asset id." }
}
}
}
}
```
Bounds and enums are set per model, and a value outside them returns
`error.code: "run.parameter_invalid"`, naming the field.
## Metering
`pricing` describes how a model meters, not what it charges. `meter` is
`output_seconds`, which bills by the duration of the output, or
`request`, which is a flat cost per call.
Some duration-metered models also carry `rounding` and a `duration_basis`
that says whether the meter counts the duration requested or the duration
delivered. Request-metered models carry `minimum_credits`.
[Credits and limits](/reference/quotas) covers what a run is actually
charged.
## Supported models
The table below lists supported inference models by type. For the latest
models, visit [protoface.com/models](https://protoface.com/models?utm_source=docs\&utm_medium=referral\&utm_campaign=models\&utm_content=guides-models).
| Model | Provider | Type |
| - | - | - |
| Qwen Image 3.0
`alibaba/qwen-image-3.0` | 
Alibaba | Image |
| Wan 3.0
`alibaba/wan-3.0` | Alibaba | Video |
| Wan 3.0 Prime
`alibaba/wan-3.0-prime` | Alibaba | Video |
| FLUX.2 Pro
`black-forest-labs/flux-2-pro` | 
Black Forest Labs | Image |
| FLUX.2 Turbo
`black-forest-labs/flux-2-turbo` | Black Forest Labs | Image |
| FLUX.3 Video
`black-forest-labs/flux-3` | Black Forest Labs | Video |
| Seed Speech TTS 2.0
`bytedance/seed-speech-tts-2.0` | 
ByteDance | Audio |
| Seedance 2.0
`bytedance/seedance-2.0` | ByteDance | Video |
| Seedance 2.0 Fast
`bytedance/seedance-2.0-fast` | ByteDance | Video |
| Seedance 2.0 Mini
`bytedance/seedance-2.0-mini` | ByteDance | Video |
| Seedance 2.5
`bytedance/seedance-2.5` | ByteDance | Video |
| Seedream 5.0 Pro
`bytedance/seedream-5.0-pro` | ByteDance | Image |
| Eleven v3
`elevenlabs/eleven-v3` | 
ElevenLabs | Audio |
| Eleven Music
`elevenlabs/music` | ElevenLabs | Audio |
| ElevenLabs Voice Changer
`elevenlabs/voice-changer` | ElevenLabs | Audio |
| Lyria 3 Pro
`google/lyria-3-pro` | 
Google | Audio |
| Nano Banana 2
`google/nano-banana-2` | Google | Image |
| Veo 3.1
`google/veo-3.1` | Google | Video |
| Veo 3.1 Lite
`google/veo-3.1-lite` | Google | Video |
| Ideogram V4
`ideogram-ai/ideogram-v4` | 
Ideogram | Image |
| Ideogram Remove Background
`ideogram-ai/remove-background` | Ideogram | Image |
| Kling 3.0 Pro
`kuaishou/kling-3.0-pro` | 
Kuaishou | Video |
| Kling 3 Turbo Pro
`kuaishou/kling-3.0-turbo` | Kuaishou | Video |
| LTX 2.5 Fast
`lightricks/ltx-2.5-fast` | 
Lightricks | Video |
| Luma Ray 3.2
`luma/ray-3.2` | 
Luma | Video |
| LongCat Avatar 1.5
`meituan/longcat-avatar-1.5` | 
Meituan | Video |
| MAI Image 2.5
`microsoft/mai-image-2.5` | 
Microsoft | Image |
| MiniMax Hailuo 2.3
`minimax/hailuo-2.3` | 
MiniMax | Video |
| MiniMax H3
`minimax/minimax-h3` | MiniMax | Video |
| MiniMax Music 3.0
`minimax/music-3.0` | MiniMax | Audio |
| GPT Image 2
`openai/gpt-image-2` | 
OpenAI | Image |
| Pika 2.2
`pika/pika-2.2` | 
Pika | Video |
| MiniMax H3 FastH3 (Preview)
`protoface/minimax-h3-fasth3` | 
Protoface | Video |
| Seedance 2.0
`protoface/seedance-2.0` | Protoface | Video |
| P-Image
`pruna-ai/p-image` | 
Pruna | Image |
| Recraft V4.1
`recraft-ai/recraft-v4.1` | 
Recraft | Image |
| Runway Aleph 2
`runway/aleph-2` | 
Runway | Video |
| Runway Gen-4 Image
`runway/gen-4-image` | Runway | Image |
| Runway Gen-4 Turbo
`runway/gen-4-turbo` | Runway | Video |
| Sync Lipsync 3
`sync/lipsync-3` | 
Sync | Video |
| Hunyuan3D V3
`tencent/hunyuan3d-v3` | 
Tencent | 3D |
| Tripo H3.1
`tripo3d/h3.1` | 
Tripo | 3D |
| Grok Imagine Image 2.0
`xai/grok-imagine-image-2` | 
xAI | Image |
| Grok Imagine Video 1.5
`xai/grok-imagine-video-1.5` | xAI | Video |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.