trae-community/trae-skills/zopia-ai-skills
Claude Code and agent skill by trae-community/trae-skills
- community
Checking that the SKILL.md file is still in the repository.
Drive AI video production via the Zopia API: create projects, configure styles, chat with the Agent to generate screenplays/characters/storyboards/videos, and query project status and credits. Use when the user wants to create AI video projects or interact with the Zopia platform through its API.
Install
npx vskill@latest install trae-community/trae-skills/zopia-ai-skillsSKILL.md
The same SKILL.md was published earlier as trae-community/trae-skills/zopia-ai-skills.
Zopia External Agent Skill
Zopia is an AI-driven video production platform. Through its API you can create projects, configure settings, then converse with the platform's built-in Agent, which automatically handles screenplay writing, character design, storyboard illustration, and video generation.
Authentication
Guide the user to visit https://zopia.ai/settings/api-tokens, log in, and click "Generate New Token".
- Format:
zopia-xxxxxxxxxxxx - Validity: 30 days
Include in every request header:
Recommended Workflow
Agent chat is the core interaction. Describe your needs in natural language and the Agent will automatically dispatch tools to:
- Write screenplays (
screenplay_writer) - Design characters (
character_designer) - Draw storyboard keyframes (
storyboard_artist) - Generate video clips (
video_producer)
Multi-turn conversations: Do not pass session_id on the first call; the response will return a generated session_id. Pass that session_id on subsequent calls to continue within the same session. Omitting session_id starts a new conversation.
Core API Endpoints
1. Create Project
Body: { "baseName": "My Project", "lang": "zh-CN" }
Returns baseId used in all subsequent calls.
2. Save Settings (required before Agent chat)
Body:
Three fields are required before Agent chat: locale, aspect_ratio, style. Always pass `generation_method` explicitly; server defaults to n_grid if omitted.
3. Agent Chat
Body:
base_id: requiredmessage: required, natural language instructionsession_id: optional, for continuing a conversation
Concurrency: Only one request per session_id at a time; returns 409 if another is still running. Latency: Image, storyboard, and video generation can be slow. Wait for each response before sending the next request.
4. Other Endpoints
GET /api/base/settings?base_id=base_xxx- Read current settingsGET /api/base/list- List all projects (newest first)GET /api/base/{id}- Project details including sessions and settingsGET /api/billing/getBalance- Query credit balance
For full API details, request bodies, and response schemas, see API_REFERENCE.md. For all settings values (styles, video models, generation methods), see SETTINGS_REFERENCE.md. For conversation examples and video generation best practices, see EXAMPLES.md.
Video Generation Best Practices
Video generation is expensive. Always confirm the number of shots with the user before generating. Never generate all shots at once.
After storyboarding, use workspace.files[].record_count to get the shot count, ask the user which range to generate, then generate in batches of 3-5 shots.
Error Codes
| Code | Meaning | |
|---|---|---|
400 | Bad parameters / missing settings | |
401 | Unauthenticated or token expired | |
402 | Insufficient credits | |
403 | No permission (not project owner) | |
404 | Resource not found | |
409 | Session already running, retry later |
Quick Start
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/zopia_ai_skills/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/trae-community/trae-skills/zopia-ai-skills)