JQSP video agent skills — short dramas, talking-head videos, images and voice-overs from your AI agent
中文说明 · Site: jqsp.com · API keys: jqsp.com/settings/apikeys · Pricing: jqsp.com/pricing
Teach your AI assistant (Claude Code, Codex, OpenClaw, or any agent that can read a Markdown file and run curl) the JQSP skills, and it can produce video for you through the public API:
- Short dramas: from a script or novel to finished episodes — chapters, characters, scenes and props, voices, storyboard, one video per shot, export.
- Medium-length videos: you give the story shot by shot, the agent builds the video (the 15-minute format).
- Single videos: one request → one 5, 10 or 15-second video.
- Talking-head videos: a digital presenter speaking to camera, in 5 presenting styles you can mix; your own voice and photo if you like; subtitles, callouts and transitions in post.
- Images: single pictures, Nano Banana, and 4 / 6 / 9-panel storyboard sheets.
- Voice-over: text to speech with the public voices or your own.
- Balance, prices and model availability: free to read at any time.
The agent works menu-first and quote-first: it offers buttons instead of open questions, and before any step that costs credits it reads the price (dryRun or /estimate), tells you, and waits for your OK.
Account, key and credits
| What | How |
|---|
| Account | Sign up at jqsp.com/sign-up. If the page asks for an invite code, ask the platform for one. New accounts start with free credits. |
| API key | Create one at jqsp.com/settings/apikeys. That page also shows a ready-to-paste prompt with your key filled in. |
| Scopes | read (read-only), write (free writes), charge (steps that spend credits — video, images, voice-over all need it). |
| Daily credit cap | Optional, set per key: a hard limit on what an agent can spend in a day. |
| Reading balance, prices and model status | Free (/api/v1/catalog, /api/v1/model-status). |
| Renders | Credits are held when a job is submitted and returned automatically if it fails. |
Prices change with the models on offer, so they are not copied here: the live numbers are in GET /api/v1/catalog and on jqsp.com/pricing.
Quick start
Any agent: one message
Paste this into your agent (replace the key):
Read and follow this skill first: https://jqsp.com/skills/en/jqsp-drama/SKILL.md
Use it to make a short drama or a mid-length video for me on jqsp.com (it can also generate images, voice-overs and single videos).
API key: YOUR_API_KEY (only for calling the jqsp.com API — never share it)
Nothing to install: the agent reads the entry skill from the site and follows its links to the other skills. The Chinese edition is https://jqsp.com/skills/jqsp-drama/SKILL.md.
Claude Code, Codex, Cursor: install as local skills
npx skills add clinchcc/ai-video-agent # English
npx skills add https://github.com/clinchcc/ai-video-agent/tree/main/zh-CN # 中文
Or copy by hand, Claude Code as the example:
git clone https://github.com/clinchcc/ai-video-agent.git
mkdir -p ~/.claude/skills
cp -r ai-video-agent/skills/* ~/.claude/skills/ # for Chinese: ai-video-agent/zh-CN/*
Codex reads ~/.codex/skills/; other agents have their own skills folder. Both languages use the same skill names, so install one of them. Then ask: "Make a 10-second video of a cat chasing a drone over a night city."
The skills ask the agent to re-read the entry skill from jqsp.com at the start of each session and to refresh local copies weekly, so a local install keeps up with the site.
Plain curl
export JQSP_API_KEY=... # from jqsp.com/settings/apikeys
sh examples/check-key.sh # "code": 0 means the key works
sh examples/catalog.sh # balance, models, prices (free)
sh examples/model-status.sh # which models are up (free)
sh examples/voices.sh # voices for voice-over (free)
Or by hand:
curl -s https://jqsp.com/api/v1/catalog -H "Authorization: Bearer $JQSP_API_KEY"
Every response is { "code": 0, "message": "ok", "data": … }; code other than 0 is an error and message says why. Field-level reference: skills/jqsp-drama/API.md (dramas, images, voice-over, catalog) and skills/jqsp-video/API.md (single videos).
What's in this repo
| Path | What |
|---|
skills/jqsp-drama/ | Entry skill and router for every public API, plus its sub-skills: script, characters, scenes-props, voices, storyboard, quick (medium-length video), images, tts. Mirrored from jqsp.com/skills/en/jqsp-drama/SKILL.md |
skills/jqsp-video/ | Single video: one request → one 5/10/15-second video |
skills/jqsp-talking-head/ | Talking-head video, self-contained |
zh-CN/ | The same three skills in Chinese, from jqsp.com/skills/jqsp-drama/SKILL.md |
examples/ | Small shell scripts, all free and read-only: check a key, catalog, model status, voices |
scripts/sync.sh | Refresh the skill files from jqsp.com |
The site is the source of truth: if this copy and jqsp.com differ, follow jqsp.com. Run scripts/sync.sh to update. The only edit the script makes is to the YAML header of three English files (the description is re-wrapped so strict parsers accept it); the text is unchanged.
Main endpoints
Base URL https://jqsp.com, header Authorization: Bearer <API key>.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
