Claude GitHub Copilot Skill

seedance-video

Seedance video by Ace Data Cloud. Generate text-to-video and image-to-video, use multimodal references, or edit and extend video. Use when the user asks for Seedance 2.0 or 2.5 video generation.

LLM Mart · 0 points · 6 views 0 listing impressions 0 install-command copies
Download acedatacloud-skills-skills_seedance-video-c3d1703.zip · 10 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/seedance-video
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

README

Seedance by Ace Data Cloud — skills.sh first run

Use Seedance through the Ace Data Cloud API from an Agent Skills-compatible coding assistant. This Skill is maintained by Ace Data Cloud and uses your Ace service API key; it does not claim to be published by Seedance. Install it independently; the account Skill and an MCP server are optional.

简体中文 · skills.sh installation page · current models and pricing

1. Install this service only

Open the skills.sh page above and check the repository is acedatacloud/skills. In your project terminal:

npx --yes skills@1.7.2 add acedatacloud/skills --skill seedance-video -a codex --yes
npx --yes skills@1.7.2 list

This example targets Codex; replace codex with your supported agent, such as claude-code or cursor. For Codex, the installed instructions are .agents/skills/seedance-video/SKILL.md. Start a fresh session. Installation does not generate media or set up an API key. This is a Skill, not a model-provider dropdown or a new extension button.

For the released snapshot checked on 2026-10-18, use https://github.com/AceDataCloud/Skills/tree/v2026.1017.279001 in place of acedatacloud/skills. That released snapshot predates these improved instructions; use the default branch after this PR is merged to receive them.

Real skills.sh installation control

Actual account-Skill page captured on 2026-10-17, showing the same installation control. Use this service's slug above; the screenshot is not a seedance-video installation or generation result. Image sources and limits.

2. Register, sign in and get the correct API key

  1. Open Ace Data Cloud → Applications; register and sign in if needed.
  2. Open General application. If absent, choose Initialize General Application. Check Seedance access, current balance and price before submitting anything.
  3. Copy the key on the application card, or open Manage Keys → Create to create a separate key such as skills.sh Seedance. Set expiry and API/usage limits as needed. If Allowed APIs is enabled, include /seedance/videos and /seedance/tasks. Other actions in SKILL.md may need extra routes.
  4. Copy only the key value. Do not include Bearer or screenshot redaction characters. A platform-... management token is not the service key.

Copy API key or open Manage Keys

Create an optional dedicated key

These are existing, redacted Ace console screenshots from the Suno Dify guide, checked on 2026-10-18. They illustrate the shared key controls, not a Seedance run in skills.sh. The example name “Dify tutorial” is illustrative; use your own name. Menu labels may change.

3. Put the key in the assistant's execution environment

skills.sh does not store credentials. For a terminal-launched coding assistant, export the key in that terminal before starting the assistant, then start a new session:

export ACEDATACLOUD_API_TOKEN="your_api_key_here"

For an already running IDE, restart it from the configured environment or use that IDE's documented secret/environment settings. A Skill install does not load .env automatically. Never paste the key into a prompt, commit it, or print it in logs. OpenClaw has its own Gateway setup in SKILL.md; it is not required for skills.sh installation.

4. Submit once and inspect the result

Read SKILL.md and its exact request shape first. Ask your assistant to use Seedance by Ace Data Cloud, inspect the current price, and prepare a single video request using doubao-seedance-2-0-260128. Approve the intended cost before it submits /seedance/videos. Installation and a prepared request do not prove that generation ran.

Run the existing Quick Start only after the key and intended cost are correct. For an asynchronous response, save its task ID and query that same ID at /seedance/tasks. Do not resubmit generation to check progress. Wait for the terminal succeeded result and use its returned video URL.

Example request copied from this Skill's current Quick Start. Billable: run only after confirming the service, price and intended request. It has not been executed for this guide:

curl -X POST https://api.acedata.cloud/seedance/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'

If the response returns a task ID, query that ID with the following command; replace YOUR_TASK_ID with the existing ID.

curl -X POST https://api.acedata.cloud/seedance/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_TASK_ID"}'

The expected output is an actual returned audio/video/image URL after terminal success, not a URL copied from this guide. Keep the same task ID while pending.

Use the exact task response fields and terminal states in SKILL.md. A URL in this guide would be illustrative; no media generation was performed for this tutorial. Check the request/task history for one intended charge; a completed media link alone does not prove the final bill.

Troubleshooting

Symptom What to check
401 Full service key, no Bearer inside its value, available to the actual assistant process.
403 Service access, expiry and Allowed APIs; read the error because moderation can also return 403.
400 Exact model ID and request shape in SKILL.md; do not silently substitute a model.
429 Wait and reduce concurrency; do not automatically retry a paid submit.
Pending / timeout / 5xx Read the same task or request history before considering a new submit.
Media URL unavailable Confirm terminal success and use the actual returned URL; share only task/trace ID with support.

Support: dev@acedata.cloud. Source: AceDataCloud/Skills. skills.sh installation counters are not unique users or revenue. Source links use the four supported UTM fields for this skills.sh guide; they do not prove a registration or payment.

Skill manifest

Seedance by Ace Data Cloud

Generate AI dance and motion videos through AceDataCloud's Seedance (ByteDance) API.

Install and connect from skills.sh

This integration is maintained by Ace Data Cloud; it is not an official Seedance publisher listing. Install only this Skill with npx skills add acedatacloud/skills --skill seedance-video --yes, or use the public skills.sh page. Keep the slug seedance-video when selecting it.

Read the illustrated first-run guide (简体中文) for registration, Applications → General application, API key access and price checks, and the environment variable location for your coding agent. For skills.sh installations, use this guide; any ClawHub-specific setup applies only to OpenClaw. The shared references linked here are online because focused installs do not include sibling _shared/ folders.

ClawHub / OpenClaw setup

  1. Install the official Skill with clawhub install @acedatacloud/seedance. Check that the ClawHub publisher is @acedatacloud.
  2. Sign in at AceDataCloud → Applications, open General application, and check Seedance access, balance, and current pricing. Copy its API key, or select Manage Keys → Create for a separate key. Copy the key value without Bearer ; a platform-... management token is not a service API key.
  3. If you enable Allowed APIs restrictions, include /seedance/videos and /seedance/tasks. Advanced workflows below may call additional routes.
  4. On the OpenClaw Gateway host, put ACEDATACLOUD_API_TOKEN=your_api_key_here in ~/.openclaw/.env, then restart the Gateway and start a new session. For a direct terminal test, run export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that shell. Never put the key in a prompt or commit an .env file.
  5. Run the Quick Start below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.

Illustrated key setup, first run, and troubleshooting · Token details

Quick Start

curl -X POST https://api.acedata.cloud/seedance/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'

Async: See async task polling. Poll via POST /seedance/tasks with {"id": "..."}. This returns a task ID immediately. Poll for the result:

curl -X POST https://api.acedata.cloud/seedance/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "<task_id from above>"}'

Models

Seedance 2.5 (latest flagship)

Model Best For Limits
doubao-seedance-2-5-260628 Up to 30 seconds, pure-audio or multimodal reference, video edit/extend 480p, 720p, 1080p; 30 images / 10 videos / 10 audios / 50 total

Use omni_reference_task_type: "auto", "edit", or "extend". Edit and extend require reference_video and ratio: "adaptive"; edit also requires duration: -1. Optional output_format is mp4 or mov.

Seedance 2.0 (multimodal reference, up to 4k)

The 2.0 series adds multimodal reference inputs: real-person / character image references, reference audio, and reference video (see the workflows below).

Model Best For Max resolution
doubao-seedance-2-0-260128 Highest quality, real-person/character reference, 4k output 4k
doubao-seedance-2-0-fast-260128 Faster 2.0 generation 720p
doubao-seedance-2-0-mini-260615 Lightweight / most cost-effective 2.0 720p

Seedance 1.x

Model Type Best For
doubao-seedance-1-5-pro-251215 Text+Image-to-Video 1.5 flagship, audio support
doubao-seedance-1-0-pro-250528 Text+Image-to-Video General-purpose, reliable quality
doubao-seedance-1-0-pro-fast-251015 Text+Image-to-Video Faster Pro generation
doubao-seedance-1-0-lite-t2v-250428 Text-to-Video only Lightweight text-to-video
doubao-seedance-1-0-lite-i2v-250428 Image-to-Video only Lightweight image-to-video

Workflows

1. Text-to-Video

Pass a text content item in the content array.

POST /seedance/videos
{
  "model": "doubao-seedance-1-0-pro-250528",
  "content": [
    {"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

2. Image-to-Video

Include an image content item (with an optional role) alongside the text.

POST /seedance/videos
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {"type": "text", "text": "the person starts dancing gracefully"},
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {"url": "https://example.com/dancer.jpg"}
    }
  ],
  "resolution": "720p",
  "duration": 5
}

Image roles:

  • first_frame — image is used as the opening frame
  • last_frame — image is used as the closing frame
  • reference_image — image is used as a style / subject / real-person reference (Seedance 2.0 keeps the referenced person or character consistent)

Reference media (Seedance 2.x):

  • audio_url — use role: "reference_audio"
  • video_url — use role: "reference_video"
  • 2.5 accepts pure-audio reference; 2.0 requires an image or video alongside audio

3. First-frame + Last-frame

Provide both a start and end frame image:

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "smooth transition between two scenes"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
    {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
  ]
}

4. Real-person / character reference (Seedance 2.0)

Seedance 2.0 models (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) can keep a specific person or character consistent across a brand-new scene. Pass one or more photos as image_url items with role: "reference_image" — the model preserves that subject's appearance. Up to 9 reference images are accepted.

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
  ],
  "resolution": "1080p",
  "duration": 8
}

5. Reference audio / video (Seedance 2.0)

2.0 models also accept reference audio (voice timbre, background music) and reference video (subject content, camera movement, motion, overall style). Add audio_url and/or video_url content items. Limits: up to 3 audio and 3 video references per request.

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
    {"type": "audio_url", "role": "reference_audio", "audio_url": {"url": "https://example.com/voice.mp3"}},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/motion.mp4"}}
  ],
  "generate_audio": true
}

Parameters

Parameter Values Description
model see Models table Model to use (required)
content array Input items: text, image_url, audio_url (2.0), video_url (2.0) (required)
resolution "480p", "720p", "1080p", "4k" Output resolution. 4k is doubao-seedance-2-0-260128 (standard) only; 2-0-fast / 2-0-mini max out at 720p (default: 720p for pro/2.0, 480p for lite)
ratio "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" Aspect ratio (default: 16:9)
duration 2 – 30, or -1 1.0: 2–12 (no auto); 1.5 Pro: 4–12/-1; 2.0: 4–15/-1; 2.5: 4–30/-1
frames 29–289 (must satisfy 25+4n) Frame count — mutually exclusive with duration
seed -1 to 4294967295 Seed for reproducible results (-1 = random)
generate_audio true / false Generate audio (supported by doubao-seedance-1-5-pro-251215 and the doubao-seedance-2-0 series; other models ignore it)
camerafixed true / false Fix the camera position during generation
watermark true / false Add a watermark to the generated video
return_last_frame true / false Return the last frame of the generated video
omni_reference_task_type auto, edit, extend Seedance 2.5 task type
output_format mp4, mov Seedance 2.5 output format
tools object[] Seedance 2.5 web search tool, e.g. [{"type":"web_search"}]
priority 0–9 Seedance 2.5 queue priority
safety_identifier string Stable anonymous end-user ID (max 64 chars; do not send PII)
execution_expires_after number Task timeout threshold in seconds

Inline Parameter Syntax

You can also embed generation parameters directly in the text prompt using the --param value syntax:

A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42

Supported inline params: --rs (resolution), --rt (ratio), --dur (duration), --frames, --fps (24 only), --seed, --cf (camera_fixed), --wm (watermark).

Gotchas

  • Model names use the doubao-* convention (e.g. doubao-seedance-1-0-pro-250528) — old short names like seedance-1.0 are not valid
  • The content array replaces the old prompt + image_url fields; always use content
  • Image and text scenarios are mutually exclusive per content item — each item has either text or image_url, not both
  • first_frame and last_frame may be combined in one request, but reference_image is mutually exclusive with first_frame / last_frame — do not mix a reference image with first/last frames
  • generate_audio: true is supported by doubao-seedance-1-5-pro-251215 and the doubao-seedance-2-0 series; other models ignore this field
  • Lite models are split: *-lite-t2v-* only accepts text, *-lite-i2v-* only accepts image-to-video
  • audio_url and video_url reference items are supported by Seedance 2.0 and 2.5; 2.5 also supports pure-audio reference
  • Resolution options are 480p, 720p, 1080p, and 4k (4k is doubao-seedance-2-0-260128 only; 2-0-fast / 2-0-mini max out at 720p) — there is no 360p or 540p
  • Duration is model-specific: 1.0 supports 2–12; 1.5 Pro supports 4–12/-1; 2.0 supports 4–15/-1; 2.5 supports 4–30/-1
  • Task states use "succeeded" (not "completed") — check for this value when polling

MCP: pip install mcp-seedance | Hosted: https://seedance.mcp.acedata.cloud/mcp | See all MCP servers

Files (skills)
  • README.md 7.1 KB
    # Seedance by Ace Data Cloud — skills.sh first run
    
    Use Seedance through the **Ace Data Cloud** API from an Agent Skills-compatible coding assistant. This Skill is maintained by Ace Data Cloud and uses your Ace service API key; it does not claim to be published by Seedance. Install it independently; the account Skill and an MCP server are optional.
    
    [简体中文](readme.zh-CN.md) · [skills.sh installation page](https://skills.sh/acedatacloud/skills/seedance-video) · [current models and pricing](https://platform.acedata.cloud/models?utm_source=skills_sh&utm_medium=referral&utm_campaign=evergreen&utm_content=seedance_video_pricing)
    
    ## 1. Install this service only
    
    Open the skills.sh page above and check the repository is **acedatacloud/skills**. In your project terminal:
    
    ```bash
    npx --yes skills@1.7.2 add acedatacloud/skills --skill seedance-video -a codex --yes
    npx --yes skills@1.7.2 list
    ```
    
    This example targets Codex; replace `codex` with your supported agent, such as `claude-code` or `cursor`. For Codex, the installed instructions are `.agents/skills/seedance-video/SKILL.md`. Start a fresh session. Installation does not generate media or set up an API key. This is a Skill, not a model-provider dropdown or a new extension button.
    
    For the released snapshot checked on 2026-10-18, use `https://github.com/AceDataCloud/Skills/tree/v2026.1017.279001` in place of `acedatacloud/skills`. That released snapshot predates these improved instructions; use the default branch after this PR is merged to receive them.
    
    ![Real skills.sh installation control](https://raw.githubusercontent.com/AceDataCloud/Skills/0901d63b7f7d216318463b1c33976838a084da3b/docs/skills-sh/installation-page-20261017.jpg)
    
    Actual account-Skill page captured on 2026-10-17, showing the same installation control. Use this service's slug above; the screenshot is not a seedance-video installation or generation result. [Image sources and limits](https://github.com/AceDataCloud/Skills/blob/0901d63b7f7d216318463b1c33976838a084da3b/docs/skills-sh/image-sources.json).
    
    ## 2. Register, sign in and get the correct API key
    
    1. Open [Ace Data Cloud → Applications](https://platform.acedata.cloud/console/applications?utm_source=skills_sh&utm_medium=referral&utm_campaign=evergreen&utm_content=seedance_video_api_key); register and sign in if needed.
    2. Open **General application**. If absent, choose **Initialize General Application**. Check **Seedance** access, current balance and price before submitting anything.
    3. Copy the key on the application card, or open **Manage Keys → Create** to create a separate key such as `skills.sh Seedance`. Set expiry and API/usage limits as needed. If **Allowed APIs** is enabled, include `/seedance/videos` and `/seedance/tasks`. Other actions in SKILL.md may need extra routes.
    4. Copy only the key value. Do not include `Bearer ` or screenshot redaction characters. A `platform-...` management token is not the service key.
    
    ![Copy API key or open Manage Keys](https://raw.githubusercontent.com/AceDataCloud/SunoDify/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial/get-api-key-en.png)
    
    ![Create an optional dedicated key](https://raw.githubusercontent.com/AceDataCloud/SunoDify/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial/create-api-key-en.png)
    
    These are existing, redacted **Ace console** screenshots from the [Suno Dify guide](https://github.com/AceDataCloud/SunoDify/blob/8d3d03570e73324220f111f7fe343da0792a8071/README.md), checked on 2026-10-18. They illustrate the shared key controls, not a Seedance run in skills.sh. The example name “Dify tutorial” is illustrative; use your own name. Menu labels may change.
    
    ## 3. Put the key in the assistant's execution environment
    
    skills.sh does not store credentials. For a terminal-launched coding assistant, export the key in that terminal **before starting the assistant**, then start a new session:
    
    ```bash
    export ACEDATACLOUD_API_TOKEN="your_api_key_here"
    ```
    
    For an already running IDE, restart it from the configured environment or use that IDE's documented secret/environment settings. A Skill install does not load `.env` automatically. Never paste the key into a prompt, commit it, or print it in logs. OpenClaw has its own Gateway setup in SKILL.md; it is not required for skills.sh installation.
    
    ## 4. Submit once and inspect the result
    
    Read [SKILL.md](SKILL.md) and its exact request shape first. Ask your assistant to use **Seedance by Ace Data Cloud**, inspect the current price, and prepare a single video request using `doubao-seedance-2-0-260128`. Approve the intended cost before it submits `/seedance/videos`. Installation and a prepared request do not prove that generation ran.
    
    Run the existing Quick Start only after the key and intended cost are correct. For an asynchronous response, save its task ID and query **that same ID** at `/seedance/tasks`. Do not resubmit generation to check progress. Wait for the terminal `succeeded` result and use its returned video URL.
    
    Example request copied from this Skill's current Quick Start. **Billable: run only after confirming the service, price and intended request.** It has not been executed for this guide:
    
    ```bash
    curl -X POST https://api.acedata.cloud/seedance/videos \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'
    ```
    
    If the response returns a task ID, query that ID with the following command; replace `YOUR_TASK_ID` with the existing ID.
    
    ```bash
    curl -X POST https://api.acedata.cloud/seedance/tasks \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"id":"YOUR_TASK_ID"}'
    ```
    
    The expected output is an actual returned audio/video/image URL after terminal success, not a URL copied from this guide. Keep the same task ID while pending.
    
    Use the exact task response fields and terminal states in SKILL.md. A URL in this guide would be illustrative; no media generation was performed for this tutorial. Check the request/task history for one intended charge; a completed media link alone does not prove the final bill.
    
    ## Troubleshooting
    
    | Symptom | What to check |
    |---|---|
    | 401 | Full service key, no `Bearer ` inside its value, available to the actual assistant process. |
    | 403 | Service access, expiry and Allowed APIs; read the error because moderation can also return 403. |
    | 400 | Exact model ID and request shape in SKILL.md; do not silently substitute a model. |
    | 429 | Wait and reduce concurrency; do not automatically retry a paid submit. |
    | Pending / timeout / 5xx | Read the same task or request history before considering a new submit. |
    | Media URL unavailable | Confirm terminal success and use the actual returned URL; share only task/trace ID with support. |
    
    Support: [dev@acedata.cloud](mailto:dev@acedata.cloud). Source: [AceDataCloud/Skills](https://github.com/AceDataCloud/Skills). skills.sh installation counters are not unique users or revenue. Source links use the four supported UTM fields for this skills.sh guide; they do not prove a registration or payment.
    
  • readme.zh-CN.md 5.6 KB
    Loading…
  • SKILL.md 11.9 KB
    ---
    name: seedance-video
    description: Seedance video by Ace Data Cloud. Generate text-to-video and image-to-video, use multimodal references, or edit and extend video. Use when the user asks for Seedance 2.0 or 2.5 video generation.
    license: Apache-2.0
    metadata:
      author: acedatacloud
      version: "1.0"
    compatibility: Requires ACEDATACLOUD_API_TOKEN in the agent process environment and HTTPS access to api.acedata.cloud. See README.md for installation and key setup.
    ---
    
    # Seedance by Ace Data Cloud
    
    Generate AI dance and motion videos through AceDataCloud's Seedance (ByteDance) API.
    
    ## Install and connect from skills.sh
    
    This integration is maintained by **Ace Data Cloud**; it is not an official Seedance publisher listing. Install only this Skill with `npx skills add acedatacloud/skills --skill seedance-video --yes`, or use the [public skills.sh page](https://skills.sh/acedatacloud/skills/seedance-video). Keep the slug `seedance-video` when selecting it.
    
    Read the [illustrated first-run guide](README.md) ([简体中文](readme.zh-CN.md)) for registration, **Applications → General application**, API key access and price checks, and the environment variable location for your coding agent. For skills.sh installations, use this guide; any ClawHub-specific setup applies only to OpenClaw. The shared references linked here are online because focused installs do not include sibling `_shared/` folders.
    
    ## ClawHub / OpenClaw setup
    
    1. Install the official Skill with `clawhub install @acedatacloud/seedance`. Check that the ClawHub publisher is **@acedatacloud**.
    2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Seedance access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
    3. If you enable **Allowed APIs** restrictions, include `/seedance/videos` and `/seedance/tasks`. Advanced workflows below may call additional routes.
    4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
    5. Run the **Quick Start** below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.
    
    [Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)
    
    ## Quick Start
    
    ```bash
    curl -X POST https://api.acedata.cloud/seedance/videos \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'
    ```
    
    > **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Poll via `POST /seedance/tasks` with `{"id": "..."}`.
    This returns a task ID immediately. Poll for the result:
    
    ```bash
    curl -X POST https://api.acedata.cloud/seedance/tasks \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"id": "<task_id from above>"}'
    ```
    
    ## Models
    
    ### Seedance 2.5 (latest flagship)
    
    | Model | Best For | Limits |
    |-------|----------|--------|
    | `doubao-seedance-2-5-260628` | Up to 30 seconds, pure-audio or multimodal reference, video edit/extend | `480p`, `720p`, `1080p`; 30 images / 10 videos / 10 audios / 50 total |
    
    Use `omni_reference_task_type: "auto"`, `"edit"`, or `"extend"`. Edit and extend require `reference_video` and `ratio: "adaptive"`; edit also requires `duration: -1`. Optional `output_format` is `mp4` or `mov`.
    
    ### Seedance 2.0 (multimodal reference, up to 4k)
    
    The 2.0 series adds multimodal reference inputs: real-person / character **image** references, reference **audio**, and reference **video** (see the workflows below).
    
    | Model | Best For | Max resolution |
    |-------|----------|----------------|
    | `doubao-seedance-2-0-260128` | Highest quality, real-person/character reference, 4k output | `4k` |
    | `doubao-seedance-2-0-fast-260128` | Faster 2.0 generation | `720p` |
    | `doubao-seedance-2-0-mini-260615` | Lightweight / most cost-effective 2.0 | `720p` |
    
    ### Seedance 1.x
    
    | Model | Type | Best For |
    |-------|------|----------|
    | `doubao-seedance-1-5-pro-251215` | Text+Image-to-Video | 1.5 flagship, audio support |
    | `doubao-seedance-1-0-pro-250528` | Text+Image-to-Video | General-purpose, reliable quality |
    | `doubao-seedance-1-0-pro-fast-251015` | Text+Image-to-Video | Faster Pro generation |
    | `doubao-seedance-1-0-lite-t2v-250428` | Text-to-Video only | Lightweight text-to-video |
    | `doubao-seedance-1-0-lite-i2v-250428` | Image-to-Video only | Lightweight image-to-video |
    
    ## Workflows
    
    ### 1. Text-to-Video
    
    Pass a text content item in the `content` array.
    
    ```json
    POST /seedance/videos
    {
      "model": "doubao-seedance-1-0-pro-250528",
      "content": [
        {"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
      ],
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 5
    }
    ```
    
    ### 2. Image-to-Video
    
    Include an image content item (with an optional `role`) alongside the text.
    
    ```json
    POST /seedance/videos
    {
      "model": "doubao-seedance-1-5-pro-251215",
      "content": [
        {"type": "text", "text": "the person starts dancing gracefully"},
        {
          "type": "image_url",
          "role": "first_frame",
          "image_url": {"url": "https://example.com/dancer.jpg"}
        }
      ],
      "resolution": "720p",
      "duration": 5
    }
    ```
    
    Image roles:
    - `first_frame` — image is used as the opening frame
    - `last_frame` — image is used as the closing frame
    - `reference_image` — image is used as a style / subject / real-person reference (Seedance 2.0 keeps the referenced person or character consistent)
    
    Reference media (Seedance 2.x):
    - `audio_url` — use `role: "reference_audio"`
    - `video_url` — use `role: "reference_video"`
    - 2.5 accepts pure-audio reference; 2.0 requires an image or video alongside audio
    
    ### 3. First-frame + Last-frame
    
    Provide both a start and end frame image:
    
    ```json
    POST /seedance/videos
    {
      "model": "doubao-seedance-2-0-260128",
      "content": [
        {"type": "text", "text": "smooth transition between two scenes"},
        {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
        {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
      ]
    }
    ```
    
    ### 4. Real-person / character reference (Seedance 2.0)
    
    Seedance 2.0 models (`doubao-seedance-2-0-260128`, `doubao-seedance-2-0-fast-260128`, `doubao-seedance-2-0-mini-260615`) can keep a **specific person or character** consistent across a brand-new scene. Pass one or more photos as `image_url` items with `role: "reference_image"` — the model preserves that subject's appearance. Up to 9 reference images are accepted.
    
    ```json
    POST /seedance/videos
    {
      "model": "doubao-seedance-2-0-260128",
      "content": [
        {"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
        {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
      ],
      "resolution": "1080p",
      "duration": 8
    }
    ```
    
    ### 5. Reference audio / video (Seedance 2.0)
    
    2.0 models also accept reference **audio** (voice timbre, background music) and reference **video** (subject content, camera movement, motion, overall style). Add `audio_url` and/or `video_url` content items. Limits: up to 3 audio and 3 video references per request.
    
    ```json
    POST /seedance/videos
    {
      "model": "doubao-seedance-2-0-260128",
      "content": [
        {"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
        {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
        {"type": "audio_url", "role": "reference_audio", "audio_url": {"url": "https://example.com/voice.mp3"}},
        {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/motion.mp4"}}
      ],
      "generate_audio": true
    }
    ```
    
    ## Parameters
    
    | Parameter | Values | Description |
    |-----------|--------|-------------|
    | `model` | see Models table | Model to use (required) |
    | `content` | array | Input items: `text`, `image_url`, `audio_url` (2.0), `video_url` (2.0) (required) |
    | `resolution` | `"480p"`, `"720p"`, `"1080p"`, `"4k"` | Output resolution. `4k` is `doubao-seedance-2-0-260128` (standard) only; `2-0-fast` / `2-0-mini` max out at `720p` (default: 720p for pro/2.0, 480p for lite) |
    | `ratio` | `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`, `"21:9"`, `"adaptive"` | Aspect ratio (default: 16:9) |
    | `duration` | `2` – `30`, or `-1` | 1.0: 2–12 (no auto); 1.5 Pro: 4–12/-1; 2.0: 4–15/-1; 2.5: 4–30/-1 |
    | `frames` | 29–289 (must satisfy 25+4n) | Frame count — mutually exclusive with `duration` |
    | `seed` | -1 to 4294967295 | Seed for reproducible results (-1 = random) |
    | `generate_audio` | `true` / `false` | Generate audio (supported by `doubao-seedance-1-5-pro-251215` and the `doubao-seedance-2-0` series; other models ignore it) |
    | `camerafixed` | `true` / `false` | Fix the camera position during generation |
    | `watermark` | `true` / `false` | Add a watermark to the generated video |
    | `return_last_frame` | `true` / `false` | Return the last frame of the generated video |
    | `omni_reference_task_type` | `auto`, `edit`, `extend` | Seedance 2.5 task type |
    | `output_format` | `mp4`, `mov` | Seedance 2.5 output format |
    | `tools` | object[] | Seedance 2.5 web search tool, e.g. `[{"type":"web_search"}]` |
    | `priority` | 0–9 | Seedance 2.5 queue priority |
    | `safety_identifier` | string | Stable anonymous end-user ID (max 64 chars; do not send PII) |
    | `execution_expires_after` | number | Task timeout threshold in seconds |
    
    ## Inline Parameter Syntax
    
    You can also embed generation parameters directly in the text prompt using the `--param value` syntax:
    
    ```
    A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
    ```
    
    Supported inline params: `--rs` (resolution), `--rt` (ratio), `--dur` (duration), `--frames`, `--fps` (24 only), `--seed`, `--cf` (camera_fixed), `--wm` (watermark).
    
    ## Gotchas
    
    - Model names use the `doubao-*` convention (e.g. `doubao-seedance-1-0-pro-250528`) — old short names like `seedance-1.0` are not valid
    - The `content` array replaces the old `prompt` + `image_url` fields; always use `content`
    - Image and text scenarios are mutually exclusive per content item — each item has either `text` or `image_url`, not both
    - `first_frame` and `last_frame` may be combined in one request, but `reference_image` is mutually exclusive with `first_frame` / `last_frame` — do not mix a reference image with first/last frames
    - `generate_audio: true` is supported by `doubao-seedance-1-5-pro-251215` and the `doubao-seedance-2-0` series; other models ignore this field
    - Lite models are split: `*-lite-t2v-*` only accepts text, `*-lite-i2v-*` only accepts image-to-video
    - `audio_url` and `video_url` reference items are supported by Seedance 2.0 and 2.5; 2.5 also supports pure-audio reference
    - Resolution options are `480p`, `720p`, `1080p`, and `4k` (`4k` is `doubao-seedance-2-0-260128` only; `2-0-fast` / `2-0-mini` max out at `720p`) — there is no 360p or 540p
    - Duration is model-specific: 1.0 supports 2–12; 1.5 Pro supports 4–12/-1; 2.0 supports 4–15/-1; 2.5 supports 4–30/-1
    - Task states use `"succeeded"` (not "completed") — check for this value when polling
    
    > **MCP:** `pip install mcp-seedance` | Hosted: `https://seedance.mcp.acedata.cloud/mcp` | See [all MCP servers](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/mcp-servers.md)
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.