Developers

Generate AI influencer videos from your AI — or your code

Apollo Vid ships an MCP server and a REST API. Paste one snippet into Claude Code or Cursor, hand it your API key, and ask for videos in plain language: the AI picks an influencer and a format, writes the script, and polls until your MP4 is ready.

Get your API key What it generates

Quick start

1.Create an account and grab a key at Studio → Developers. Keys look like cv_… and are shown once.
2.Paste a snippet below into your tool, replacing YOUR_API_KEY.
3.Ask your AI: “List the Apollo Vid influencers and make a 45s hook-text video about …”

MCP server

Streamable HTTP endpoint at https://apollovid.com/api/mcp, authenticated with your API key as a Bearer header. Works with Claude Code, Cursor, and any MCP client that supports HTTP transports.

Claude Code

claude mcp add --transport http claudevid https://apollovid.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "claudevid": {
      "url": "https://apollovid.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tool	What it does
`generate_ugc_video`	Queue an AI influencer video: topic + avatar, a format (talking head, hook text, b-roll…), optional script, tone, duration, music, captions, CTA. Uses 1 clip credit.
`get_video_status`	Poll a job — returns status, progress, and the download URL when done.
`list_avatars`	Browse the AI influencer catalog, voices by language, formats, and every accepted option value.

REST API v1

Same capabilities without MCP. All endpoints take Authorization: Bearer cv_… and return JSON.

POST /api/v1/ugc-videos — create a job

curl -X POST https://apollovid.com/api/v1/ugc-videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Why our cold brew maker is going viral — brews in 90s, no cleanup",
    "avatarId": "heygen:AVATAR_ID_FROM_CATALOG",
    "format": "hook-text",
    "durationSec": 45,
    "aspectRatio": "9:16",
    "ctaText": "Link in bio - 20% off this week."
  }'

GET /api/v1/ugc-videos/:id — poll status

curl https://apollovid.com/api/v1/ugc-videos/VIDEO_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/v1/avatars — influencers, voices, formats + options

curl https://apollovid.com/api/v1/avatars \
  -H "Authorization: Bearer YOUR_API_KEY"

Response essentials

Create returns 201 with video.id and status: "queued".
Poll until status is done — then videoUrl holds a signed MP4 link (valid 24h; re-fetch for a fresh one). Typical render time is 3–8 minutes.
failed jobs include an errormessage and don't consume a credit.

Credits, limits & safety

Each generated video uses 1 clip credit from your plan — the same pool the studio uses.
Rate limits: 60 requests/min general, 20 video creations/hour per key.
Keys can be revoked instantly at Studio → Developers; revoked keys stop working immediately.
Keep keys server-side — anyone holding a key can spend your credits.

Ready to wire it up?

Create a key and paste the snippet — takes under a minute.

Get your API key