@acedatacloud/skills 2026.628.6 → 2026.629.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.628.6",
+  "version": "2026.629.0",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/acedatacloud/SKILL.md

@@ -5,8 +5,11 @@ description: |
   (platform.acedata.cloud). Use when the user wants to check their balance /
   remaining credits, look up API call (usage) records and spend, list or create
   or delete API keys (credentials), list subscribed services, list/create/pay
-  recharge orders, manage platform tokens, list available models, or (admins)
-  publish an announcement. This is the self-service "console" API — distinct
+  recharge orders, manage platform tokens, view referral/affiliate earnings, or
+  (admins) publish an announcement. Also covers the PUBLIC catalog & docs (no
+  token needed): service detail & pricing, API list & OpenAPI specs, datasets,
+  integrations, full-text documentation search, and the model catalog with
+  per-model credit pricing. This is the self-service "console" API — distinct
   from the data-generation APIs (image/video/music/search).
 license: Apache-2.0
 metadata:
@@ -19,7 +22,9 @@ compatibility: Requires ACEDATACLOUD_PLATFORM_TOKEN (a platform or user token).
 # AceDataCloud Platform Management
 
 Programmatically manage your AceDataCloud account: balances, usage records, API
-keys, services, orders, platform tokens, models, and announcements.
+keys, services, orders, platform tokens, models, announcements and referral
+earnings — plus browse the public catalog & docs (service pricing, API specs,
+datasets, integrations, documentation search, model catalog) without a token.
 
 This is the **management / console** API at `https://platform.acedata.cloud/api/v1`
 — the same surface the web console uses. It is **different** from the
@@ -68,6 +73,20 @@ python3 $ADC keys                             # list API keys (credentials)
 python3 $ADC orders --state Finished          # recharge orders
 python3 $ADC tokens                           # platform tokens
 python3 $ADC models                           # available chat models
+python3 $ADC distributions                    # referral status + commission history
+
+# Catalog & docs (PUBLIC — work without a token)
+python3 $ADC get-service --service suno       # one service's detail
+python3 $ADC pricing --service suno           # unit, free_amount and cost
+python3 $ADC apis --service suno              # API endpoints for a service
+python3 $ADC spec --path /suno/audios         # one API's OpenAPI definition + cost
+python3 $ADC datasets                         # downloadable datasets
+python3 $ADC integrations                     # third-party integrations
+python3 $ADC docs-search --query "suno lyrics" --lang en   # full-text doc search
+python3 $ADC docs-list                        # browse documentation pages
+python3 $ADC doc --id <document-uuid>         # one doc's full content
+python3 $ADC model-catalog --modality chat    # rich model catalog + credit pricing
+python3 $ADC model --model claude             # look up a model by id/name
 
 # Safe write (require --yes to actually execute)
 python3 $ADC create-key  --application <app-id> --name "ci" --yes
@@ -206,6 +225,22 @@ Filters: `api_id`, `application_id`, `status_code`, `created_at_from`,
 OpenAI-style (no pagination): `{ "object": "list", "data": [ { "id": "gpt-4.1",
 "label": "GPT-4.1", "owned_by": "openai", "type": "chat", "capabilities": ["vision"] } ] }`
 
+### Catalog & docs (PUBLIC — no token required)
+
+These work without auth (send the token if you have one; not required):
+
+- **Service detail / pricing** — `GET /services/?id=<uuid>` → `items[0]` (full: `cost`, `unit`,
+  `free_amount`, `title`). The `services/?alias=` filter is **ignored** server-side, so resolve an
+  alias by paging `services/` and matching `alias` client-side. The `services/{id}/` detail route is broken (500).
+- **APIs** — `GET /apis/?path=<path>` → exactly one item with its OpenAPI `definition` + `cost`.
+  `apis/?service_id=` is **ignored** server-side; filter by `service_id` client-side. `apis/{id}/` is broken (500).
+- **Datasets / integrations** — `GET /datasets/`, `GET /integrations/`.
+- **Doc search** — `GET /search/?query=<text>&lang=<code>` → `{ results: [ { id, alias, title, type, snippet, url } ] }`.
+  The param is **`query`** (not `keyword`).
+- **Doc content** — `GET /documents/?id=<uuid>` → `items[0].content`. `documents/{id}/` (id or slug) is broken (404).
+- **Model catalog** — `GET /models/catalog/` → `{ rates, modalities, count, items:[{ id, name, provider,
+  modality, unit, capabilities, pricing:{ input_credits, output_credits, official_* } }] }`. Filter client-side.
+
 ### Announcements — `GET /announcements/`
 
 Public read: `{ "count": 20, "items": [ { "id", "title", "content",
@@ -241,4 +276,4 @@ publishing announcements are **irreversible or money-related**. Always:
 - Announcement endpoints under `/admin/` require a **superuser** token; a normal
   token gets `403`.
 
-> **MCP:** `pip install mcp-acedatacloud` | See [all MCP servers](../_shared/mcp-servers.md). The MCP exposes these as tools (`platform_get_balance`, `platform_list_usage`, `platform_create_credential`, `platform_create_announcement`, …) with the same write-confirmation guard.
+> **MCP:** `pip install mcp-acedatacloud` | Hosted: `https://mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md). The MCP exposes these as tools (`acedatacloud_get_balance`, `acedatacloud_list_usage`, `acedatacloud_get_pricing`, `acedatacloud_search_docs`, `acedatacloud_get_api_spec`, `acedatacloud_create_credential`, …) with the same write-confirmation guard.

package/skills/acedatacloud/scripts/acedatacloud.py

@@ -18,6 +18,7 @@ import argparse
 import datetime as dt
 import json
 import os
+import re
 import sys
 import urllib.error
 import urllib.parse
@@ -32,18 +33,9 @@ def _die(msg: str, code: int = 1) -> None:
     sys.exit(code)
 
 
-def _token(args: argparse.Namespace) -> str:
-    token = args.token or os.environ.get("ACEDATACLOUD_PLATFORM_TOKEN", "")
-    if not token:
-        _die(
-            "no platform token. Set ACEDATACLOUD_PLATFORM_TOKEN or pass --token.\n"
-            "Create one at https://platform.acedata.cloud/console/platform-tokens"
-        )
-    return token
-
-
 def _request(args: argparse.Namespace, method: str, path: str,
-             params: dict | None = None, body: dict | None = None) -> tuple[int, object]:
+             params: dict | None = None, body: dict | None = None,
+             auth_required: bool = True) -> tuple[int, object]:
     base = args.base_url.rstrip("/")
     url = f"{base}/api/v1{path}"
     if params:
@@ -51,11 +43,16 @@ def _request(args: argparse.Namespace, method: str, path: str,
         if clean:
             url += "?" + urllib.parse.urlencode(clean, doseq=True)
     data = json.dumps(body).encode() if body is not None else None
-    req = urllib.request.Request(url, data=data, method=method, headers={
-        "accept": "application/json",
-        "authorization": f"Bearer {_token(args)}",
-        "content-type": "application/json",
-    })
+    headers = {"accept": "application/json", "content-type": "application/json"}
+    token = args.token or os.environ.get("ACEDATACLOUD_PLATFORM_TOKEN", "")
+    if token:
+        headers["authorization"] = f"Bearer {token}"
+    elif auth_required:
+        _die(
+            "no platform token. Set ACEDATACLOUD_PLATFORM_TOKEN or pass --token.\n"
+            "Create one at https://platform.acedata.cloud/console/platform-tokens"
+        )
+    req = urllib.request.Request(url, data=data, method=method, headers=headers)
     try:
         with urllib.request.urlopen(req, timeout=args.timeout) as resp:
             raw = resp.read().decode("utf-8")
@@ -72,7 +69,7 @@ def _request(args: argparse.Namespace, method: str, path: str,
 
 
 def _get_all(args: argparse.Namespace, path: str, params: dict | None = None,
-             page: int = 200, cap: int = 2000) -> tuple[int, list]:
+             page: int = 200, cap: int = 2000, auth_required: bool = True) -> tuple[int, list]:
     """Fetch every page of a {count, items} list endpoint (capped)."""
     base = dict(params or {})
     out: list = []
@@ -80,7 +77,7 @@ def _get_all(args: argparse.Namespace, path: str, params: dict | None = None,
     total = 0
     while len(out) < cap:
         base.update({"limit": page, "offset": offset})
-        status, payload = _request(args, "GET", path, base)
+        status, payload = _request(args, "GET", path, base, auth_required=auth_required)
         _check_ok(status, payload)
         items = payload.get("items", []) if isinstance(payload, dict) else []
         total = payload.get("count", 0) if isinstance(payload, dict) else 0
@@ -142,6 +139,29 @@ def _since(days: int | None) -> str | None:
     return (dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=days)).strftime("%Y-%m-%dT%H:%M:%SZ")
 
 
+_UUID = re.compile(r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")
+
+
+def _resolve_service(args, ref: str) -> dict | None:
+    """Resolve a service by UUID (services/?id=) or alias (paginated match).
+
+    The platform's services/?alias= filter is ignored server-side, so alias
+    lookups page through the catalog and match client-side.
+    """
+    ref = ref.strip()
+    if _UUID.match(ref):
+        status, payload = _request(args, "GET", "/services/", {"id": ref}, auth_required=False)
+        _check_ok(status, payload)
+        items = payload.get("items", []) if isinstance(payload, dict) else []
+        return items[0] if items else None
+    target = ref.lower()
+    _, items = _get_all(args, "/services/", page=50, cap=600, auth_required=False)
+    for it in items:
+        if (it.get("alias") or "").lower() == target:
+            return it
+    return None
+
+
 # ---- read commands -------------------------------------------------------
 
 def cmd_balance(args):
@@ -261,6 +281,179 @@ def cmd_announcements(args):
     _emit(args, payload, rows, ("id", "title", "rank", "publish_at"))
 
 
+# ---- catalog & docs commands (public, no token needed) ------------------
+
+def cmd_get_service(args):
+    svc = _resolve_service(args, args.service)
+    if not svc:
+        _die(f"no service matched '{args.service}'", code=2)
+    _emit(args, svc)
+
+
+def cmd_pricing(args):
+    svc = _resolve_service(args, args.service)
+    if not svc:
+        _die(f"no service matched '{args.service}'", code=2)
+    out = {
+        "service_id": svc.get("id"),
+        "alias": svc.get("alias"),
+        "title": svc.get("title"),
+        "type": svc.get("type"),
+        "unit": svc.get("unit"),
+        "free_amount": svc.get("free_amount"),
+        "cost": svc.get("cost"),
+    }
+    _emit(args, out)
+
+
+def cmd_apis(args):
+    sid = None
+    if args.service:
+        svc = _resolve_service(args, args.service)
+        if not svc:
+            _die(f"no service matched '{args.service}'", code=2)
+        sid = svc.get("id")
+    # apis/?service_id= is ignored server-side, so filter client-side.
+    _, items = _get_all(args, "/apis/", page=50, cap=2000, auth_required=False)
+    if sid:
+        items = [it for it in items if it.get("service_id") == sid]
+    items = items[: args.limit]
+    slim = [{k: v for k, v in it.items() if k != "definition"} for it in items]
+    rows = [(
+        (it.get("path") or ""),
+        it.get("method"),
+        it.get("stage"),
+        (it.get("title") or "")[:30],
+    ) for it in items]
+    _emit(args, {"count": len(slim), "items": slim}, rows, ("path", "method", "stage", "title"))
+
+
+def cmd_spec(args):
+    status, payload = _request(args, "GET", "/apis/", {"path": args.path}, auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    if not items:
+        _die(f"no API matched path '{args.path}'", code=2)
+    api = items[0]
+    _emit(args, {
+        "id": api.get("id"),
+        "service_id": api.get("service_id"),
+        "title": api.get("title"),
+        "path": api.get("path"),
+        "method": api.get("method"),
+        "stage": api.get("stage"),
+        "cost": api.get("cost"),
+        "definition": api.get("definition"),
+    })
+
+
+def cmd_datasets(args):
+    status, payload = _request(args, "GET", "/datasets/", {"limit": args.limit}, auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    rows = [(it.get("id", "")[:8], (it.get("title") or "")[:30], it.get("price"), (it.get("part") or "")) for it in items]
+    _emit(args, payload, rows, ("id", "title", "price", "part"))
+
+
+def cmd_integrations(args):
+    status, payload = _request(args, "GET", "/integrations/", {"limit": args.limit}, auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    rows = [(it.get("id", "")[:8], (it.get("title") or "")[:34], it.get("stage")) for it in items]
+    _emit(args, payload, rows, ("id", "title", "stage"))
+
+
+def cmd_docs_search(args):
+    status, payload = _request(args, "GET", "/search/", {"query": args.query, "lang": args.lang}, auth_required=False)
+    _check_ok(status, payload)
+    results = payload.get("results", []) if isinstance(payload, dict) else []
+    rows = [((r.get("title") or "")[:44], r.get("type"), r.get("matched_lang"), (r.get("id") or "")[:8]) for r in results]
+    _emit(args, payload, rows, ("title", "type", "lang", "id"))
+
+
+def cmd_docs_list(args):
+    status, payload = _request(args, "GET", "/documents/", {"limit": args.limit, "type": args.type}, auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    rows = [(it.get("id", "")[:8], (it.get("title") or "")[:40], it.get("type"), it.get("alias")) for it in items]
+    _emit(args, {"count": payload.get("count") if isinstance(payload, dict) else None, "items": items}, rows,
+          ("id", "title", "type", "alias"))
+
+
+def cmd_doc(args):
+    if not _UUID.match(args.id.strip()):
+        _die("doc id must be a document UUID", code=2)
+    status, payload = _request(args, "GET", "/documents/", {"id": args.id.strip()}, auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    if not items:
+        _die(f"no document with id '{args.id}'", code=2)
+    _emit(args, items[0])
+
+
+def cmd_model_catalog(args):
+    status, payload = _request(args, "GET", "/models/catalog/", auth_required=False)
+    _check_ok(status, payload)
+    items = payload.get("items", []) if isinstance(payload, dict) else []
+    if args.modality:
+        m = args.modality.lower()
+        items = [it for it in items if (it.get("modality") or "").lower() == m]
+    if args.provider:
+        pv = args.provider.lower()
+        items = [it for it in items if pv in (it.get("provider") or "").lower()]
+    rows = [(
+        it.get("id"),
+        it.get("provider"),
+        it.get("modality"),
+        (it.get("pricing") or {}).get("input_credits"),
+        (it.get("pricing") or {}).get("output_credits"),
+    ) for it in items]
+    out = {"modalities": payload.get("modalities") if isinstance(payload, dict) else None,
+           "count": len(items), "items": items}
+    _emit(args, out, rows, ("id", "provider", "modality", "in_credits", "out_credits"))
+
+
+def cmd_model(args):
+    status, payload = _request(args, "GET", "/models/catalog/", auth_required=False)
+    _check_ok(status, payload)
+    q = args.model.strip().lower()
+    items = [it for it in (payload.get("items", []) if isinstance(payload, dict) else [])
+             if q in (it.get("id") or "").lower() or q in (it.get("name") or "").lower()]
+    if not items:
+        _die(f"no model matched '{args.model}'", code=2)
+    rows = [(
+        it.get("id"),
+        it.get("provider"),
+        it.get("modality"),
+        (it.get("pricing") or {}).get("input_credits"),
+        (it.get("pricing") or {}).get("output_credits"),
+    ) for it in items]
+    _emit(args, {"count": len(items), "items": items}, rows,
+          ("id", "provider", "modality", "in_credits", "out_credits"))
+
+
+def cmd_distributions(args):
+    status, status_payload = _request(args, "GET", "/distribution-statuses/", {"limit": 1})
+    _check_ok(status, status_payload)
+    st_items = status_payload.get("items", []) if isinstance(status_payload, dict) else []
+    hstatus, hist = _request(args, "GET", "/distribution-histories/", {"limit": args.limit})
+    _check_ok(hstatus, hist)
+    hitems = hist.get("items", []) if isinstance(hist, dict) else []
+    out = {
+        "status": st_items[0] if st_items else None,
+        "history_count": hist.get("count") if isinstance(hist, dict) else None,
+        "history": hitems,
+    }
+    rows = [(
+        (it.get("created_at") or "")[:10],
+        it.get("price"),
+        it.get("reward"),
+        it.get("percentage"),
+        "invalid" if it.get("invalid") else "ok",
+    ) for it in hitems]
+    _emit(args, out, rows, ("date", "price", "reward", "pct", "state"))
+
+
 # ---- write commands (gated by --yes) -------------------------------------
 
 def _guard(args, action: str, detail: dict) -> bool:
@@ -405,6 +598,47 @@ def build_parser() -> argparse.ArgumentParser:
     sp = add("announcements", cmd_announcements, "list announcements")
     sp.add_argument("--limit", type=int, default=20)
 
+    sp = add("distributions", cmd_distributions, "referral status + commission history")
+    sp.add_argument("--limit", type=int, default=20)
+
+    # ---- catalog & docs (public, no token needed) ----
+    sp = add("get-service", cmd_get_service, "one service's detail by alias or id")
+    sp.add_argument("--service", required=True, help="service alias or UUID")
+
+    sp = add("pricing", cmd_pricing, "a service's unit, free_amount and cost")
+    sp.add_argument("--service", required=True, help="service alias or UUID")
+
+    sp = add("apis", cmd_apis, "list API endpoints (optionally per service)")
+    sp.add_argument("--service", help="scope to a service alias or UUID")
+    sp.add_argument("--limit", type=int, default=50)
+
+    sp = add("spec", cmd_spec, "one API's OpenAPI definition + cost, by path")
+    sp.add_argument("--path", required=True, help="API path, e.g. /suno/audios")
+
+    sp = add("datasets", cmd_datasets, "list downloadable datasets")
+    sp.add_argument("--limit", type=int, default=50)
+
+    sp = add("integrations", cmd_integrations, "list third-party integrations")
+    sp.add_argument("--limit", type=int, default=50)
+
+    sp = add("docs-search", cmd_docs_search, "full-text search the documentation")
+    sp.add_argument("--query", required=True)
+    sp.add_argument("--lang", help="language code, e.g. en, zh-cn")
+
+    sp = add("docs-list", cmd_docs_list, "browse documentation pages")
+    sp.add_argument("--limit", type=int, default=30)
+    sp.add_argument("--type", help="document type filter, e.g. Text")
+
+    sp = add("doc", cmd_doc, "fetch one doc's full content by UUID")
+    sp.add_argument("--id", required=True, help="document UUID")
+
+    sp = add("model-catalog", cmd_model_catalog, "rich model catalog with credit pricing")
+    sp.add_argument("--modality", help="chat/video/image/music/search/embedding")
+    sp.add_argument("--provider", help="filter by provider substring")
+
+    sp = add("model", cmd_model, "look up a model by id/name")
+    sp.add_argument("--model", required=True)
+
     sp = add("create-key", cmd_create_key, "create an API key (needs --yes)")
     sp.add_argument("--application", required=True)
     sp.add_argument("--name")

package/skills/seedance-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: seedance-video
-description: Generate AI dance and motion videos with Seedance (ByteDance) via AceDataCloud API. Use when creating videos from text prompts or animating images into motion videos. Supports multiple models with configurable resolution, aspect ratio, duration, and optional audio generation.
+description: Generate AI videos with Seedance (ByteDance) via AceDataCloud API. Use when creating videos from text prompts, animating images into motion videos, or driving Seedance 2.0 multimodal generation with real-person / character image references, reference audio, and reference video. Supports multiple models with configurable resolution (up to 4k), aspect ratio, duration, and optional audio generation.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -20,7 +20,7 @@ Generate AI dance and motion videos through AceDataCloud's Seedance (ByteDance)
 curl -X POST https://api.acedata.cloud/seedance/videos \
   -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
   -H "Content-Type: application/json" \
-  -d '{"model": "doubao-seedance-1-0-pro-250528", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
+  -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
 ```
 
 > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /seedance/tasks` with `{"id": "..."}`.
@@ -35,11 +35,23 @@ curl -X POST https://api.acedata.cloud/seedance/tasks \
 
 ## Models
 
+### Seedance 2.0 (current generation — multimodal reference)
+
+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-5-pro-251215` | Text+Image-to-Video | Latest model, highest quality, audio support |
 | `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 |
 
@@ -86,7 +98,11 @@ POST /seedance/videos
 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/content reference
+- `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.0 only):
+- `audio_url` — reference audio for voice timbre / background music (no `role`)
+- `video_url` — reference video for subject, camera movement, motion or overall style (no `role`)
 
 ### 3. First-frame + Last-frame
 
@@ -95,7 +111,7 @@ Provide both a start and end frame image:
 ```json
 POST /seedance/videos
 {
-  "model": "doubao-seedance-1-0-pro-250528",
+  "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"}},
@@ -104,18 +120,53 @@ POST /seedance/videos
 }
 ```
 
+### 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", "audio_url": {"url": "https://example.com/voice.mp3"}},
+    {"type": "video_url", "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 and/or image_url objects (required) |
-| `resolution` | `"480p"`, `"720p"`, `"1080p"` | Output resolution (default: 720p for pro, 480p for lite) |
+| `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` – `12` | Duration in seconds |
-| `frames` | 29–289 (must satisfy 25+4n) | Frame count — mutually exclusive with `duration` |
+| `duration` | `2` – `15` | Duration in seconds (Seedance 2.0 supports 4–15) |
+| `frames` | 29–361 (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 (only supported by `doubao-seedance-1-5-pro-251215`) |
+| `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 |
@@ -137,12 +188,13 @@ Supported inline params: `--rs` (resolution), `--rt` (ratio), `--dur` (duration)
 - 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`, `last_frame`, and `reference_image` roles are mutually exclusive scenarios — pick one pattern per request
-- `generate_audio: true` is only supported by `doubao-seedance-1-5-pro-251215`; other models ignore this field
+- `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
-- Resolution options are `480p`, `720p`, `1080p` — there is no 360p or 540p
+- `audio_url` and `video_url` reference items are used by the **Seedance 2.0 series only**
+- 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
 - `service_tier` values are `"default"` and `"flex"` (not "standard"/"premium")
-- Duration range is **2–12 seconds** — values outside this range will fail
+- Duration range is **2–15 seconds** (Seedance 2.0 supports 4–15) — values outside this range will fail
 - 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](../_shared/mcp-servers.md)