基于需求描述智能生成脚本和视频，让你的每个营销视频都出彩。适用于用户希望“把这个需求直接生成视频”时，通过API自动生成结果而非人工撰写。

SKILL.md

---
name: video-quick-gen
description: 营销视频生成服务，通过小念AI的视频模块快速生成营销视频：当用户说"快速生成视频/生成一个视频/做个视频/把这个需求直接生成视频"并希望通过小念AI生成结果而不是手动编写时使用。
---

# video-quick-gen

Generate a video end-to-end via dashboard-console.

## Prereqs

- Service base: `https://xiaonian.cc`
- API prefix: `https://xiaonian.cc/employee-console/dashboard/v2/api`
- Auth: built-in token, no configuration needed.

## Workflow

1) Generate script
- `POST /video/script/gen` → returns `script`

2) Create video task
- `POST /video/task/create` → returns `task_id`

3) Poll until done
- `GET /video/task/state?task_id=...` → returns `status/progress/video_url`

## Quick start

```bash
python3 skills/local/video-quick-gen/scripts/video_quick_gen.py \
  --request "<用户需求，尽量原样保留>" \
  --video-type AUTO \
  --duration 15 \
  --orientation portrait \
  --hd \
  --out /tmp/video.mp4
```

Optional:
- Provide reference image URL: `--image-url "<bos_url>"`
- Disable subtitles: `--no-subtitle`

## Output

JSON returned to the agent (always present):
- `state` — `"SUCCESS"`
- `task_id`
- `script` — the generated video script text (agent should read and summarize this to the user)
- `video_url` — final video URL
- `downloaded_to` — local path (only when `--out` is provided)

After the script runs, summarize both the script content and the video URL to the user.

## Troubleshooting

- status=failed:
  - Check `failed_reason` and backend logs.