# MobyVid API

> Prepaid-credit REST API and MCP server for e-commerce ads (images, video, voice, music, captions) in Spanish and English. No subscription.

Base URL https://mobyvid.com/api/v1. Auth: `Authorization: Bearer <key>` (keys start with mv_live_). Paid POSTs take an `Idempotency-Key` header and `max_credits`. Jobs answer 202 with an id: poll GET /api/v1/jobs/<id>?wait=30. Out of credits is 402 with needed and balance; failed jobs are refunded. MCP server: https://mobyvid.com/mcp.

## Docs
- [Getting started](https://mobyvid.com/en/docs.md): keys, credits, estimate, create, poll, download, idempotency, errors, rate limits
- [API reference](https://mobyvid.com/en/docs/api.md): every endpoint with parameters, responses and curl
- [MCP setup](https://mobyvid.com/en/docs/mcp.md): Claude Code, Codex, Cursor, tools and money rules
- [Agent kit](https://mobyvid.com/en/docs/agent.md): agent prompt, skill and FFmpeg finishing recipes
- [OpenAPI](https://mobyvid.com/api/v1/openapi.json): OpenAPI 3.1 document

## Agent files
- [SKILL.md](https://mobyvid.com/agent/mobyvid-ads/SKILL.md): Agent Skill for Claude Code, Codex and Cursor
- [ffmpeg.md](https://mobyvid.com/agent/mobyvid-ads/references/ffmpeg.md): FFmpeg recipes to finish ads
- [MCP](https://mobyvid.com/mcp): remote MCP server (Streamable HTTP, Bearer key)

## Optional
- [Full docs in one file](https://mobyvid.com/llms-full.txt): every page above in one Markdown file
- [Documentación en español](https://mobyvid.com/es/llms.txt): Spanish version