Multi API

Submit text, get video. The Multi API lets you integrate video production into any workflow — from scripts and CI pipelines to AI agents. All endpoints require an active subscription.

Authentication

All API requests are authenticated with a Bearer token. Generate a key from your account page under API Keys.

# Pass your key in the Authorization header
Authorization: Bearer mk_live_your_key_here

Quick start

Submit content, poll until done, download the files.

# 1. Submit a job
curl -X POST https://makemulti.com/api/v1/jobs \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"content": "Your content here..."}'

# Returns:
# { "job_id": "abc123", "status": "processing" }

# 2. Poll for completion
curl https://makemulti.com/api/v1/jobs/abc123 \
  -H "Authorization: Bearer mk_live_..."

# When done, returns signed download URLs:
# { "status": "completed", "video_url": "...", "podcast_url": "..." }

Errors

Errors return a JSON object with an error field and an appropriate HTTP status code.

Submit a job

{
  "content": "Your content here — changelog, doc, blog post, anything...",
  "visual_style": "stock",
  "webhook_url": "https://yourapp.com/hooks/multi"
}

{
  "job_id": "d4e5f6a7-...",
  "status": "processing",
  "created_at": "2026-03-05T12:00:00.000Z"
}

Get job status

{
  "job_id": "d4e5f6a7-...",
  "status": "processing",
  "created_at": "2026-03-05T12:00:00.000Z"
}

{
  "job_id": "d4e5f6a7-...",
  "status": "completed",
  "title": "The Rise of Zero-Person Companies",
  "video_duration": 187,
  "render_ratio": 4.2,
  "video_url": "https://makemulti.com/api/v1/files/d4e5.../video?token=...&expires=...",
  "podcast_url": "https://makemulti.com/api/v1/files/d4e5.../podcast?token=...&expires=...",
  "captions_url": "https://makemulti.com/api/v1/files/d4e5.../captions?token=...&expires=...",
  "completed_at": "2026-03-05T12:07:33.000Z",
  "created_at": "2026-03-05T12:00:00.000Z"
}

List jobs

{
  "jobs": [
    {
      "job_id": "d4e5f6a7-...",
      "status": "completed",
      "title": "The Rise of Zero-Person Companies",
      "video_duration": 187,
      "render_ratio": 4.2,
      "source": "api",
      "created_at": "2026-03-05T12:00:00.000Z"
    }
  ],
  "count": 1
}

Signed download URLs

Download URLs returned by GET /api/v1/jobs/:id and webhook payloads are time-limited signed URLs. They expire after 24 hours. No API key is required to use them — the signed URL itself is the authorization token.

This means you can safely hand a video URL to another service (a YouTube upload agent, a CDN, a storage bucket) without sharing your API key.

Usage & credits

{
  "credits_used": 142,
  "credits_limit": 100,
  "credits_remaining": 58,
  "overage_accrued_cents": 0,
  "overage_limit_cents": 1000,
  "plan": "starter",
  "current_period_end": "2026-04-05T00:00:00.000Z"
}

API key management

Keys can be managed from your account page or programmatically via the API (using an existing key to create or revoke others).

// Request — name is optional
{ "name": "my-agent" }

// Response — 201 Created
{
  "id": "key-uuid",
  "key": "mk_live_a1b2c3d4e5f6...",
  "key_prefix": "mk_live_a1b2c3d4...",
  "name": "my-agent",
  "created_at": "2026-03-05T12:00:00.000Z",
  "note": "Save this key — it will not be shown again."
}

{ "success": true }

Webhook management

Register webhook URLs to receive POST notifications when jobs complete or fail. Each webhook has a unique HMAC signing secret — use it to verify the payload came from Multi.

// Request
{
  "url": "https://yourapp.com/hooks/multi",
  "events": ["job.completed", "job.failed"]
}

// Response — 201 Created
{
  "id": "webhook-uuid",
  "url": "https://yourapp.com/hooks/multi",
  "events": ["job.completed", "job.failed"],
  "secret": "a1b2c3d4...",
  "note": "Save this secret — it will not be shown again."
}

{ "success": true }

Webhook events

Multi sends a POST to your registered URL when a job completes or fails. The payload includes signed download URLs (valid 24 hours).

job.completed

{
  "event": "job.completed",
  "job_id": "d4e5f6a7-...",
  "status": "completed",
  "title": "The Rise of Zero-Person Companies",
  "video_duration": 187,
  "render_ratio": 4.2,
  "video_url": "https://makemulti.com/api/v1/files/...",
  "podcast_url": "https://makemulti.com/api/v1/files/...",
  "captions_url": "https://makemulti.com/api/v1/files/...",
  "timestamp": "2026-03-05T12:07:33.000Z"
}

job.failed

{
  "event": "job.failed",
  "job_id": "d4e5f6a7-...",
  "status": "failed",
  "timestamp": "2026-03-05T12:07:33.000Z"
}

Verifying webhook signatures

Every registered webhook POST includes an X-Multi-Signature header. Verify it to confirm the payload came from Multi and wasn't tampered with. Per-job webhooks (via the webhook_url field) do not include a signature.

// Node.js verification example
import crypto from 'crypto';

function verifyWebhook(rawBody, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(rawBody)  // rawBody must be the raw string, not parsed JSON
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// In your Express handler:
app.post('/hooks/multi', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-multi-signature'];
  if (!verifyWebhook(req.body, sig, process.env.MULTI_WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  const payload = JSON.parse(req.body);
  // handle payload.event === 'job.completed' etc.
  res.sendStatus(200);
});

MCP server for AI agents

Multi ships an MCP (Model Context Protocol) server that wraps the API as tools for Claude, GPT, and other MCP-enabled agents. Instead of writing API integration code, your agent can call Multi natively.

Tools available

Setup

Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent config on your OS.

Claude Code: Add to .mcp.json in your project root or ~/.claude/mcp.json globally.

{
  "mcpServers": {
    "multi": {
      "command": "node",
      "args": ["/path/to/multi/mcp-server.mjs"],
      "env": {
        "MULTI_API_KEY": "mk_live_...",
        "MULTI_API_URL": "https://makemulti.com"
      }
    }
  }
}

Example agent session

# In a Claude conversation, after MCP is configured:

User: Turn this product update into a video and upload it to YouTube.

Claude: I'll submit it to Multi first.
[calls create_video with the content]
→ job_id: d4e5f6a7, status: processing

[polls get_job_status after a few minutes]
→ status: completed
→ video_url: https://makemulti.com/api/v1/files/...

[passes video_url to YouTube upload tool]
→ Uploaded. YouTube URL: https://youtu.be/...