Guides

Models

The model is the AI that plans your lesson, writes the narration and designs the visuals. A stronger model gives clearer explanations and more reliable animations, especially for long or advanced topics.

How it works

• Leave model out and you get Claude Haiku 5.5 (anthropic/claude-haiku-5.5), which every plan includes.
• Pass model with any id from the table below to choose one.
• Each plan includes a set of models that run on our key, at no extra cost.
• With your own provider key, every model works on every plan, including the ones marked “Your key”.

All models

“Included from” is the cheapest plan that includes the model on our key. Context is how much text the model can consider at once.

What each plan includes

Your plan’s monthly video limit applies whichever model you use. See Pricing.

Choosing a model

• Short, focused topics (“What is a hash map?”): Claude Haiku 5.5 is fast and clear.
• Math and derivations: DeepSeek V4 Pro is excellent for its price; Claude Opus 5.5 and GPT-6.1 Sol Pro handle the hardest proofs.
• Best all-rounder: Claude Sonnet 5.5. Well-paced lessons and the most reliable animations.
• Charts, diagrams, science: Gemini 3.1 Pro.
• Long or advanced lectures: Claude Opus 5.5.
• Non-English audiences: Qwen 3.8 Max (with your own key).

Using a model

Pass the id as model. If your plan doesn’t include it and you haven’t connected a key that can run it, the request fails with 403 before anything is charged.

curl -sS -X POST "$MANIMOTION_API/video/request" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $MANIMOTION_KEY" \
  -d '{
    "prompt": "Prove that there are infinitely many primes",
    "model": "anthropic/claude-sonnet-5.5"
  }'

In the SDKs it’s the same option: videos.generate({ prompt, model: "anthropic/claude-sonnet-5.5" }) in JavaScript, videos.generate(prompt, model="…") in Python.

Listing models in code

GET /models returns the catalog. Send your API key and each model also tells you whether you can use it right now (available) and which key would run it (via: "byok" for your own key, "platform" for your plan). Without a key you get the public list.

curl -sS "$MANIMOTION_API/models" \
  -H "x-api-key: $MANIMOTION_KEY"

{
  "default_model": "anthropic/claude-sonnet-5.5",
  "plan": "free",
  "providers": [
    { "id": "openrouter", "name": "OpenRouter", "connected": false },
    { "id": "openai", "name": "OpenAI", "connected": false },
    { "id": "anthropic", "name": "Anthropic", "connected": true },
    { "id": "gemini", "name": "Google Gemini", "connected": false }
  ],
  "models": [
    {
      "id": "anthropic/claude-sonnet-5.5",
      "name": "Claude Sonnet 5.5",
      "vendor": "anthropic",
      "plan": "hobby",
      "byok_only": false,
      "badge": "Recommended",
      "description": "The best all-rounder: well-paced lessons and reliable animations.",
      "context": 1000000,
      "providers": ["anthropic", "openrouter"],
      "available": true,
      "via": "byok"
    },
    {
      "id": "openai/gpt-6.1-sol",
      "name": "GPT-6.1 Sol",
      "vendor": "openai",
      "plan": "hobby",
      "byok_only": false,
      "badge": "Balanced",
      "description": "OpenAI's flagship. Strong reasoning and tidy, well-structured slides.",
      "context": 1050000,
      "providers": ["openai", "openrouter"],
      "available": false,
      "via": null
    }
  ]
}

The SDKs wrap this as models.list().

Any OpenRouter model

With an OpenRouter key connected, you aren’t limited to this list: pass any model id from openrouter.ai/models exactly as OpenRouter writes it.

Retired model ids

Older ids keep working. On our key they run on their replacement; with your own key they’re sent to your provider as written.