---
title: "Generate a Seedance video using a skill as the prompt template"
method: POST
path: "/api/v1/claude/skills/{skill_id}/generate-video"
tags: ["claude"]
---

# Generate a Seedance video using a skill as the prompt template

`POST /api/v1/claude/skills/{skill_id}/generate-video`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/claude/skills/{skill_id}/generate-video`
- Auth: HTTP bearer

Generate a Seedance 2.0 video using a Claude skill as the creative template.

**Flow:**
1. The skill's `SKILL.md` style guide (e.g. *seedance-cinematic*, *seedance-ecommerce-ad*)
   is loaded into Claude's context via the Anthropic Skills container.
2. Claude applies the skill's rules to transform your plain-text `script`
   into a polished Seedance video prompt.
3. The prompt is passed to the Seedance 2.0 (Kie) video generation pipeline
   and processed in the background.

**Returns** immediately with `task_id` and `project_id`. Poll
`GET /ai-video-storyboard/task-status/{task_id}` for progress.

**Optional inputs:**
- `product_image_url` → injected as `@image1` in the prompt
- `avatar_url` → injected as `@image2` in the prompt
- `reference_audio_url` → injected as `@audio1` where the skill supports it

## Path parameters

- `skill_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)