---
name: create-video
description: >
  Create Seedance 2.0 videos via Unsora — text-to-video, image-to-video with
  reference frames, UGC-style clips, and product demos. Use when the user wants
  to generate, animate, or make a video with Unsora, Seedance, or Seedance 2.0.
---

# Create Video (Seedance 2.0)

Generate video through Unsora's `create_video` MCP tool (Seedance 2.0 only).

---

## Prerequisites

- Unsora MCP connected (OAuth via plugin or API key)
- Sufficient credits (`get_credits`)

---

## Workflow

1. **Clarify intent** — subject, setting, duration (4–15s), aspect ratio (`9:16` social, `16:9` landscape, `1:1` feed)
2. **Reference assets** — if image-to-video, collect public HTTPS URLs for `image_files` (up to 9) or `filePaths` for first/last frame mode
3. **Check credits** — `get_credits`
4. **Create** — `create_video` with:
   - `prompt` — scene, motion, camera, dialogue if any
   - `ratio` — default `9:16` for social unless user specifies
   - `duration` — 4–15 seconds
   - `functionMode` — `omni_reference` (default) or `first_last_frames` when animating between two frames
   - `image_files` / `video_files` / `audio_files` when conditioning on references
5. **Preview hosts (Claude.ai)** — live video preview polls automatically. **Do not** call `wait_for_video` afterward.
6. **Other hosts** — `wait_for_video` with `generationId` until `COMPLETED`; read `outputUrl` from response.

---

## Prompt tips (Seedance 2.0)

Structure prompts in layers:

1. **Shot type** — selfie UGC, product hero, b-roll, studio lookbook
2. **Subject + action** — who/what is on screen and what they do
3. **Environment** — kitchen, studio, outdoor, dark void
4. **Camera** — handheld iPhone, slow dolly, static tripod
5. **Lighting** — golden hour, soft window light, high-key studio
6. **Audio/dialogue** — embedded speech if the scene includes talking (keep concise for short clips)

**UGC example:** *"9:16 selfie-style clip, woman in bright kitchen holding skincare bottle, casual iPhone handheld, natural window light, she glances at camera and says the product replaced her old routine, authentic not polished."*

**Product hero example:** *"16:9 slow rotation of wireless earbuds on black reflective surface, mist and soft rim light, no person, premium reveal energy."*

---

## Image-to-video

When the user provides a still:

- Use `image_files: ["https://..."]` with `functionMode: "omni_reference"`
- Or `filePaths` with two URLs for first/last frame transitions

Confirm the image URL is publicly reachable.

---

## After delivery

Offer: different ratio, longer duration (within 15s), schedule to TikTok/Instagram (`unsora:schedule-post`), or generate a companion thumbnail.

---

## Errors

- **Insufficient credits** — show balance, suggest top-up at app.tryunsora.com/billing
- **FAILED status** — read error message, simplify prompt or reduce reference count, retry once