Models

The model catalog tells you which video models are available and what each one accepts. Read it at runtime instead of keeping a fixed list in your application.

List models

curl https://api.protoface.com/v1/models \
  -H "Authorization: Bearer $PROTOFACE_API_KEY"

Each model includes:

id: the value used in POST /v1/run/{model_id}.
operations: supported operations and their input fields.
input_modalities and output_modalities: accepted and returned media.
pricing: current credit pricing.
request_schemas: JSON Schema for the request, when available.
revision and contract_revision: versions of the model and its API contract.

Retrieve one model

curl https://api.protoface.com/v1/models/minimax-h3 \
  -H "Authorization: Bearer $PROTOFACE_API_KEY"

Use operations and request_schemas to build the request. Models can differ in duration, quality, aspect ratio, and supported reference media.

Submit to a model

Put the model ID in the URL:

curl -X POST https://api.protoface.com/v1/run/minimax-h3 \
  -H "Authorization: Bearer $PROTOFACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A close shot of rain moving across a window at night.",
    "duration_seconds": 8,
    "quality": "768p",
    "aspect_ratio": "16:9"
  }'

If a model is unavailable or the request is invalid for that model, the API rejects the run before reserving credits.

Model inference

Run your first model.

Runs

Monitor and retrieve inference results.

Get Started

Model Inference

Realtime

Account

Reference

List models

Retrieve one model

Submit to a model

Next

Model inference

Runs

​List models

​Retrieve one model

​Submit to a model

​Next

Model inference

Runs

List models

Retrieve one model

Submit to a model

Next