GenPixy API & MCP

Explainer videos your AI agent can make

Give Claude Code, Codex, OpenClaw, Hermes, or your own app one sentence. Get back a narrated video with subtitles, a thumbnail, and a ready YouTube title.

Paste this into your AI agent

Read https://www.genpixy.com/api/skill.md and make me a 60-second explainer video about how black holes form.

Get an API key Read the docs

Works with any agent that can read a web page and run a command, and with every MCP client

Claude Code
Codex
OpenClaw
Hermes Agent
Cursor
MCP
Your own code

How it works

Three steps

Create a key

Sign in, open Account, then API keys, and create a key. You see it only once, so copy it.
gpx_k3V9xQ2m••••••••
Give it to your agent

Set GENPIXY_API_KEY, connect the MCP server, or paste the key when your agent asks for it.
export GENPIXY_API_KEY=gpx_…
Ask for a video

Your agent starts the video, checks its progress, and saves the MP4 when it is ready.
✓ video.mp4 · png · srt

GET /api/v1/videos/{id}

What you get back

GET /api/v1/videos/{id} 200 OK

{"id": "01a16c52-6024-7b92-b252-53f87f2303dd""status": "completed""request": {"seconds": 60"orientation": "landscape""resolution": "1080p""style": "whiteboard""language": "auto"},"result": {"title": "How Black Holes Form""duration_seconds": 61.4"youtube_title": "How Do Black Holes Form? Explained Simply""youtube_description": "…""hashtags": ["#space", "#science"]"files": {"video": ".../01a16c52…/content?variant=video""thumbnail": ".../01a16c52…/content?variant=thumbnail""subtitles": ".../01a16c52…/content?variant=subtitles"}}}

MCP · HTTP

Connect your agent in one command

Connect the GenPixy MCP server to Claude Code, Codex, Cursor, or any MCP client. Your agent gets tools to create and check videos, list them, and read your balance.

Server URL

https://www.genpixy.com/api/mcp

Tools your agent gets

create_video
get_video
list_videos
get_account
get_options

claude mcp add --transport http genpixy https://www.genpixy.com/api/mcp \
  --header "Authorization: Bearer $GENPIXY_API_KEY"

codex mcp add genpixy --url https://www.genpixy.com/api/mcp \
  --bearer-token-env-var GENPIXY_API_KEY

# 1. Create
curl -s https://www.genpixy.com/api/v1/videos \
  -H "Authorization: Bearer $GENPIXY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-first-video" \
  -d '{"prompt":"How black holes form","seconds":60}'

# 2. Check every 10 s until "status" is "completed"
curl -s https://www.genpixy.com/api/v1/videos/<id> \
  -H "Authorization: Bearer $GENPIXY_API_KEY"

# 3. Download
curl -L -o video.mp4 \
  "https://www.genpixy.com/api/v1/videos/<id>/content?variant=video" \
  -H "Authorization: Bearer $GENPIXY_API_KEY"