voooai

Short drama & webtoon production, text-to-image, image-to-image, storyboard design, text-to-video, image-to-video, video edit, style transfer, batch generation, music & soundtrack. Describe your creative needs → backend generates workflow → execute → poll status → download results. Upload reference files (images, videos, audio) → workflow uses them as input for generation. If a node fails → retry that node with adjusted parameters. Complex tasks (short dramas, full ads) may take 3-5 min. Your role: relay user requests verbatim to backend. Backend AI (Analyst + Expert + Reviewer) handles all creative decisions. Do NOT rewrite prompts, decompose tasks, or construct workflows yourself — just forward and retrieve. Requires VOOOAI_ACCESS_KEY (creative operations only, no billing/admin). Use when: users request any visual or audio content creation, generation, editing, or modification.

# VoooAI - NL2Workflow Creative Platform

## 1. Overview

VoooAI is a **multi-media creative platform** with 70+ built-in AI skills. The Agent acts as a **relay** (搬运工) — forwarding user requests to VoooAI's backend, which handles all creative decisions via its multi-role AI system (Analyst + Expert + Reviewer).

**Core Capabilities:**
- **Image Generation**: Text-to-image, image-to-image, style transfer, concept art, storyboards
- **Video Generation**: Text-to-video, image-to-video, video editing, digital human, AI anchor
- **Music Generation**: Full songs, instrumentals, background music, soundtracks
- **Workflow Orchestration**: Multi-step automated pipelines (script → storyboard → video + music)

### 1.1 Who Should Use This Skill?

| User Type | Use Cases |
|-----------|-----------|
| **Content Creators** | Marketing videos, social media content, product showcases, promotional materials |
| **Designers** | Design assets, style variants, visual concepts, mood boards |
| **Studios** | Multi-step creative pipelines (script → storyboard → video + music) |
| **Businesses** | Advertising, e-commerce product videos, corporate training content |
| **Game Developers** | Game art assets, character concept art, cutscene animations |
| **Educators** | Tutorial videos, course illustrations, animated demonstrations |
| **One-Person Companies** | Full-stack content creation (posters, videos, music — all-in-one) |

### 1.2 When NOT to Use This Skill

This skill is **exclusively for creative workflow operations**. The following are explicitly **out of scope**:

- ❌ User account management (registration, login, profile changes)
- ❌ Billing, subscription, or payment operations
- ❌ Admin panel or system configuration
- ❌ Analytics, statistics, or usage data queries
- ❌ Homepage or dashboard features
- ❌ Direct parameter tuning (let the backend AI system handle optimization)

For these operations, direct users to https://voooai.com

## 2. Authentication

### VOOOAI_ACCESS_KEY
- **Source**: User's VoooAI account page at https://voooai.com
- **Format**: `vooai_` prefix + 40 random alphanumeric characters (46 total)
- **Example**: `vooai_abc123def456ghi789jkl012mno345pqrs678`

### Scope (What the Key Allows)
- ✅ Capability discovery (`check_capabilities.py`)
- ✅ File upload (`upload_file.py`)
- ✅ Workflow generation (`generate_workflow.py`)
- ✅ Workflow execution (`execute_workflow.py`, `execute_single_node.py`)
- ✅ Status query (`get_status.py`)
- ✅ Result download (`download_results.py`)

### Scope (What the Key DOES NOT Allow)
- ❌ Billing / payment / subscription management
- ❌ Admin / system administration
- ❌ User account settings / profile changes
- ❌ Analytics / statistics access

### Storage
- Environment variable: `export VOOOAI_ACCESS_KEY="vooai_..."`
- Never hardcode in source code

## 3. Scope and Restrictions

### Allowed Operations
- Capability discovery, file upload, workflow generation/execution, status query, result download

### Forbidden Operations (Explicit Deny List)
If user requests these, inform them to visit voooai.com directly:
- ❌ Homepage / dashboard features
- ❌ User registration / login / authentication
- ❌ Subscription / payment / billing management
- ❌ Admin panel / system administration
- ❌ Analytics / statistics
- ❌ Account settings / profile management

**Content Moderation (Explicit Deny List)**
- ❌ Creating deepfakes or non-consensual facial/voice mimicry
- ❌ Impersonating real individuals without explicit consent
- ❌ Generating political disinformation or election interference content

> **Content Safety Note**: Digital human and talking-head features are intended for legitimate 
> creative use cases (marketing presenters, educational hosts, fictional characters). 
> Users must label AI-generated content per applicable synthetic media regulations.

## 4. Scope Boundaries

This section provides a clear table-based definition of what this skill can and cannot do.

### Supported Operations

| Operation | Supported | Script | Example |
|-----------|-----------|--------|---------|
| Capability discovery | ✅ | check_capabilities.py | Check available skills and points balance |
| File upload | ✅ | upload_file.py | Upload reference image/video/audio (max 200MB) |
| Workflow generation | ✅ | generate_workflow.py | Generate workflow from natural language description |
| Workflow execution | ✅ | execute_workflow.py | Run generated workflow |
| Single node execution | ✅ | execute_single_node.py | Retry specific failed node |
| Status query | ✅ | get_status.py | Check execution progress |
| Result download | ✅ | download_results.py | Download generated files to local |

### Forbidden Operations

| Operation | Reason |
|-----------|--------|
| User authentication / registration | Out of scope — handled by web frontend |
| Payment / billing / subscription | Out of scope — user manages directly at voooai.com |
| Account settings / profile | Out of scope — user manages directly |
| Analytics / usage statistics | Out of scope — not creative workflow |
| Admin panel / system config | Out of scope — admin only |
| Homepage / dashboard features | Out of scope — not workflow related |
| Direct API calls bypassing scripts | Security risk — use provided scripts only |
| Manual workflow JSON construction | Quality risk — use generate_workflow.py only |
| Deepfakes / non-consensual facial or voice mimicry | Content safety — violates ethical guidelines |
| Impersonating real individuals without consent | Content safety — privacy and legal concerns |
| Political disinformation / election interference | Content safety — harmful content prohibition |

## 5. Available Scripts

All scripts located at `{baseDir}/scripts/`. Required env: `VOOOAI_ACCESS_KEY`.

### check_capabilities.py
Discover platform capabilities and points balance.
```bash
python3 {baseDir}/scripts/check_capabilities.py
python3 {baseDir}/scripts/check_capabilities.py --summary
```

### upload_file.py
Upload image/video/audio file (max 200MB).
```bash
python3 {baseDir}/scripts/upload_file.py /path/to/file.png
python3 {baseDir}/scripts/upload_file.py /path/to/video.mp4
```
- Supported: jpg, png, webp, gif, mp4, mov, avi, mkv, webm, mp3, wav, flac, m4a

### generate_workflow.py
Generate workflow from natural language description.
```bash
python3 {baseDir}/scripts/generate_workflow.py "生成一个咖啡产品宣传视频"
python3 {baseDir}/scripts/generate_workflow.py "基于这张图生成视频" --reference-urls https://example.com/ref.jpg
python3 {baseDir}/scripts/generate_workflow.py "生成分镜图" --skill-id storyboard-basic
python3 {baseDir}/scripts/generate_workflow.py "测试描述" --analyze-only  # analysis only
```

### execute_workflow.py
Execute a generated workflow.
```bash
python3 {baseDir}/scripts/execute_workflow.py '{"nodes": [...], "connections": [...]}'
python3 {baseDir}/scripts/execute_workflow.py /path/to/workflow.json
cat workflow.json | python3 {baseDir}/scripts/execute_workflow.py --from-stdin
python3 {baseDir}/scripts/execute_workflow.py workflow.json --set-param node_1.prompt="新提示词"
```

### execute_single_node.py
Execute/retry a single node (for debugging or partial retry).
```bash
python3 {baseDir}/scripts/execute_single_node.py workflow.json --node-id node_1
cat workflow.json | python3 {baseDir}/scripts/execute_single_node.py --from-stdin --node-id node_2
python3 {baseDir}/scripts/execute_single_node.py workflow.json --node-id node_1 --set-param node_1.prompt="修改后的提示词"
```

### get_status.py
Query execution status.
```bash
python3 {baseDir}/scripts/get_status.py exec_abc123                            # single query
python3 {baseDir}/scripts/get_status.py exec_abc123 --poll                     # poll until complete
python3 {baseDir}/scripts/get_status.py exec_abc123 --poll --timeout 600       # custom timeout
```

### download_results.py
Download execution r