Protoface API

Protoface is a generative media inference platform, running frontier models for video, images, speech, music, 3D assets, and realtime avatars behind a single API key.

Inference

Generating a video takes one call to start it and one to fetch the result. In the example below, MiniMax H3 returns eight seconds of video with sound.

curl -X POST https://api.protoface.com/v1/run/minimax/minimax-h3 \
  -H "Authorization: Bearer $PROTOFACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A wide shot of a sailboat crossing a quiet bay at sunrise.",
    "duration_seconds": 8,
    "quality": "768p",
    "aspect_ratio": "16:9"
  }'

The request returns a run ID immediately, and GET /v1/runs/{id} carries the file once the run finishes.

{
  "id": "run_...",
  "status": "completed",
  "video": {
    "url": "https://...",
    "content_type": "video/mp4",
    "file_name": "output.mp4"
  }
}

Every model follows this pattern. Only the body changes, and you build it from the model’s catalog entry. The inference quickstart runs the full sequence.

Realtime

Protoface Realtime adds a realtime face to your voice agent, driven by the audio it already produces. It works across languages and with any pipeline, whether speech-to-speech or separate STT, LLM, and TTS. Use the LiveKit or Pipecat plugin, another supported platform, or the REST API. The realtime quickstart adds a live avatar to a LiveKit agent.

Next steps

Inference quickstart

Generate a video with curl, Python, or JavaScript.

Model catalog

Browse every model and read its input contract.

Realtime quickstart

Run a LiveKit agent with a live avatar.

Other integrations

Starters for Pipecat, Agora, Vapi, and more.

Avatars

Create and manage avatars for realtime sessions.

Errors

Stable error codes, rate limits, and retries.

Inference

Realtime

Account

Reference

Inference

Realtime

Next steps

Inference quickstart

Model catalog

Realtime quickstart

Other integrations

Avatars

Errors

​Inference

​Realtime

​Next steps

Inference quickstart

Model catalog

Realtime quickstart

Other integrations

Avatars

Errors

Inference

Realtime

Next steps