Automate with the API
Use the VidMachine REST API to create projects, generate videos, list and edit content from your scripts or external apps. Or connect the MCP server to generate from Claude Code, Codex, Cursor, and other AI assistants. Both use the same API keys and the same credits as your account—no separate limits.
What you can do
- List and create projects
Manage projects and their settings via GET/POST /api/v1/projects. - Create videos for a project
POST a title (and optionally trigger full generation) to create a video idea and run the pipeline. - List videos with filters
GET /api/v1/videos with optional project_id, status, limit, and offset. - Update project and video settings
PATCH projects and videos (e.g. title, status, scheduled post time) with the same rules as the dashboard. - Queue any model
POST /api/v1/generations with a model ID from GET /api/v1/models, then poll for the output URL. - Connect an AI assistant
Register the MCP server in Claude Code, Codex, or Cursor and generate from chat with the same API key.
Authentication
Create an API key in your account (API Keys in the sidebar). Use it in the
Authorization: Bearer YOUR_API_KEY header for every request. Keep your key secret and rotate it (revoke + create) if needed.MCP server
The Model Context Protocol server lets Claude Code, Codex, Cursor, and other AI assistants call VidMachine for you. Authenticate with the same API key—no separate setup.
# Claude Code
claude mcp add --transport http vidmachine \
https://vidmachine.ai/api/mcp \
--header 'Authorization: Bearer ${VIDMACHINE_API_KEY}'