GenPixy API & MCP

你的 AI 智能体也能做讲解视频

对 Claude Code、Codex、OpenClaw、Hermes 或你自己的应用说一句话，就能拿回带旁白、字幕、封面和可直接使用的 YouTube 标题的视频。

把这段话粘贴给你的 AI 智能体

阅读 https://www.genpixy.com/api/skill.md，帮我做一个 60 秒的讲解视频，讲讲黑洞是怎么形成的。

获取 API 密钥查看文档

适用于任何能读网页、能运行命令的智能体，也支持所有 MCP 客户端

Claude Code
Codex
OpenClaw
Hermes Agent
Cursor
MCP
你自己的代码

使用方法

三步搞定

创建密钥

登录后打开账户，进入 API 密钥并创建一个密钥。它只会显示一次，记得复制。
gpx_k3V9xQ2m••••••••
交给你的智能体

设置 GENPIXY_API_KEY，连接 MCP 服务器，或在智能体询问时粘贴密钥。
export GENPIXY_API_KEY=gpx_…
要一个视频

你的智能体会开始制作视频、查看进度，做好后保存 MP4。
✓ video.mp4 · png · srt

GET /api/v1/videos/{id}

你会得到什么

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

一条命令连接你的智能体

把 GenPixy MCP 服务器连接到 Claude Code、Codex、Cursor 或任何 MCP 客户端。你的智能体可以创建和查看视频、列出视频，还能查看你的余额。

服务器 URL

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

你的智能体可用的工具

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"