# GenPixy API

> The GenPixy API turns a topic or a script into a narrated explainer video. You start a video with one call, check it until it is done, and download the files. AI agents can use the same API through SKILL.md or the MCP server.

- Base URL: https://www.genpixy.com/api/v1
- Authentication: send `Authorization: Bearer $GENPIXY_API_KEY` on every call. Create a key at https://www.genpixy.com/account/api-keys.
- MCP server: https://www.genpixy.com/api/mcp (Streamable HTTP, the same API key as a Bearer token)

## Docs

- [Quick start](https://www.genpixy.com/api/docs#quick-start): Base URL: https://www.genpixy.com/api/v1.
- [Authentication](https://www.genpixy.com/api/docs#authentication): Create a key at Account → API keys.
- [Use with AI agents](https://www.genpixy.com/api/docs#use-with-ai-agents): The fastest way: paste this prompt into any agent that can read a web page and run a command (Claude Code, Codex, OpenClaw, Hermes Agent, and others).
- [MCP server](https://www.genpixy.com/api/docs#mcp-server): GenPixy has a remote MCP (Model Context Protocol) server.
- [Connect your client](https://www.genpixy.com/api/docs#connect-your-client): Other clients (Cursor, VS Code, Windsurf, and more) take a JSON entry like this.
- [Tools](https://www.genpixy.com/api/docs#tools): Tool results are the same JSON objects as the HTTP API.
- [Create a video](https://www.genpixy.com/api/docs#create-a-video)
- [POST /api/v1/videos](https://www.genpixy.com/api/docs#post-api-v1-videos): The body is a JSON object.
- [Check a video](https://www.genpixy.com/api/docs#check-a-video)
- [GET /api/v1/videos/{id}](https://www.genpixy.com/api/docs#get-api-v1-videos-id): Check every 10 seconds.
- [Download files](https://www.genpixy.com/api/docs#download-files)
- [GET /api/v1/videos/{id}/content](https://www.genpixy.com/api/docs#get-api-v1-videos-id-content): Before the video is completed: 409 VIDEO_NOT_READY.
- [List videos](https://www.genpixy.com/api/docs#list-videos)
- [GET /api/v1/videos](https://www.genpixy.com/api/docs#get-api-v1-videos): Returns {"object": "list", "data": [...], "next_cursor": "…"} with 24 videos per page, newest first.
- [Account and options](https://www.genpixy.com/api/docs#account-and-options)
- [GET /api/v1/account](https://www.genpixy.com/api/docs#get-api-v1-account)
- [GET /api/v1/options](https://www.genpixy.com/api/docs#get-api-v1-options): Returns every option of POST /api/v1/videos, the defaults, and costs: the cost of each length and resolution for your account.
- [Prices and limits](https://www.genpixy.com/api/docs#prices-and-limits): Each video uses your GenPixy balance, at the same price as the app.
- [Errors](https://www.genpixy.com/api/docs#errors): Every error has the same shape.
- [Changelog](https://www.genpixy.com/api/docs#changelog): 2026-11-03: v1 released, with the MCP server.

## Agent files

- [API docs as Markdown](https://www.genpixy.com/api/docs.md): The whole API docs in one file.
- [SKILL.md](https://www.genpixy.com/api/skill.md): Agent Skills file: how an AI agent makes a GenPixy video with the API.
- [OpenAPI](https://www.genpixy.com/api/openapi.json): OpenAPI 3.1 description of /api/v1.

## Optional

- [GenPixy llms.txt](https://www.genpixy.com/llms.txt): What GenPixy is, its pages, examples, and languages.