@acedatacloud/skills 2026.629.1 → 2026.629.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.629.1",
+  "version": "2026.629.3",
   "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/seedance-video/SKILL.md

@@ -35,7 +35,9 @@ curl -X POST https://api.acedata.cloud/seedance/tasks \
 
 ## Models
 
-The Seedance 2.0 series adds multimodal reference inputs: real-person / character **image** references, reference **audio**, and reference **video** (see the workflows below).
+### 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 |
 |-------|----------|----------------|
@@ -43,6 +45,16 @@ The Seedance 2.0 series adds multimodal reference inputs: real-person / characte
 | `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
@@ -52,7 +64,7 @@ Pass a text content item in the `content` array.
 ```json
 POST /seedance/videos
 {
-  "model": "doubao-seedance-2-0-260128",
+  "model": "doubao-seedance-1-0-pro-250528",
   "content": [
     {"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
   ],
@@ -69,7 +81,7 @@ Include an image content item (with an optional `role`) alongside the text.
 ```json
 POST /seedance/videos
 {
-  "model": "doubao-seedance-2-0-260128",
+  "model": "doubao-seedance-1-5-pro-251215",
   "content": [
     {"type": "text", "text": "the person starts dancing gracefully"},
     {
@@ -154,7 +166,7 @@ POST /seedance/videos
 | `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 (supported by the `doubao-seedance-2-0` series; other models ignore it) |
+| `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 |
@@ -173,11 +185,11 @@ Supported inline params: `--rs` (resolution), `--rt` (ratio), `--dur` (duration)
 
 ## Gotchas
 
-- Model names use the `doubao-*` convention (e.g. `doubao-seedance-2-0-260128`) — old short names like `seedance-1.0` are not valid
+- 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 the `doubao-seedance-2-0` series; other models ignore this field
+- `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 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

package/skills/webextrator/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: webextrator
+description: Render and extract web page content via AceDataCloud's WebExtrator API. Use when scraping a page's final rendered HTML, or extracting typed structured data (Article, Product, Recipe, Video, Discussion, Job) plus clean markdown/text from any URL. Real headless Chromium with schema.org + LLM extraction.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-webextrator for tool-use.
+---
+
+# WebExtrator Web Render & Extract
+
+Render and extract web content through AceDataCloud's WebExtrator API — real headless Chromium plus a three-tier extraction pipeline (schema.org JSON-LD mapper → LLM typed extractor → Readability/markdown fallback).
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/webextrator/extract \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com", "expected_type": "general"}'
+```
+
+Returns synchronously in seconds — no task polling needed.
+
+## Endpoints
+
+| Path | Purpose |
+|------|---------|
+| `POST /webextrator/render` | Headless Chromium render → raw HTML + clean text + title |
+| `POST /webextrator/extract` | Render + structured extraction (schema.org + LLM types) + markdown |
+| `POST /webextrator/tasks` | Look up historical render/extract task envelopes (7-day retention, free) |
+
+## Workflows
+
+### 1. Extract typed content
+
+```json
+POST /webextrator/extract
+{
+  "url": "https://example.com",
+  "expected_type": "general"
+}
+```
+
+Real response (trimmed):
+
+```json
+{
+  "success": true,
+  "task_id": "604b1cfb-6c5a-42c9-b900-a281e1b9c3c5",
+  "trace_id": "f2a7c0b0-c17c-4bc9-b6e7-9c59746dd366",
+  "elapsed": 0.003,
+  "data": {
+    "kind": "extract",
+    "url": "https://example.com",
+    "finalUrl": "https://example.com/",
+    "contentType": "general",
+    "title": "Example Domain",
+    "description": "This domain is for use in documentation examples without needing permission. Avoid use in operations.",
+    "language": "en",
+    "images": [],
+    "links": [],
+    "markdown": "...",
+    "text": "...",
+    "structured": { "schemaOrg": {}, "openGraph": {}, "jsonLd": [] }
+  }
+}
+```
+
+### 2. Render raw HTML
+
+```json
+POST /webextrator/render
+{
+  "url": "https://example.com",
+  "wait_until": "networkidle",
+  "block_resources": ["image", "media", "font"]
+}
+```
+
+Returns `data.html`, `data.text`, `data.title`, `data.status`, `data.finalUrl`.
+
+### 3. Look up a task
+
+```json
+POST /webextrator/tasks
+{
+  "action": "retrieve",
+  "id": "604b1cfb-6c5a-42c9-b900-a281e1b9c3c5"
+}
+```
+
+## Parameters
+
+### Render & Extract (shared)
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `url` | Yes | Page URL to render (`http(s)://`) |
+| `wait_until` | No | `load` / `domcontentloaded` / `networkidle` / `commit` (default `networkidle`) |
+| `timeout` | No | Navigation timeout in seconds (default 30) |
+| `delay` | No | Extra wait in seconds after `wait_until` (for SPAs) |
+| `wait_for_selector` | No | CSS selector to wait for before ready |
+| `block_resources` | No | Drop `image`/`font`/`media`/`stylesheet`/`xhr`/`fetch` |
+| `headers` | No | Extra request headers for the target site |
+| `cookies` | No | Cookies to install before navigation |
+| `mode` | No | `sync` (default) or `async` (returns job id) |
+| `callback_url` | No | Posted the final envelope when `mode=async` |
+| `bypass_cache` | No | Skip the Redis result cache for this request |
+| `cache_ttl_seconds` | No | Override cache TTL; `0` disables caching |
+
+### Extract-only
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `expected_type` | No | `product` / `article` / `general` — skips the heuristic |
+| `enable_llm` | No | Allow LLM extractor when schema.org found nothing (default false) |
+
+### Tasks
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `action` | Yes | `retrieve` (single) or `retrieve_batch` (many) |
+| `id` / `trace_id` | one of | For `retrieve` |
+| `ids` / `trace_ids` | one of | For `retrieve_batch` |
+
+## Gotchas
+
+- Parameters use **snake_case** (`wait_until`, `block_resources`), not camelCase
+- Cache hits are still billed; identical URLs return in ~0.003s
+- `expected_type` only allows `product`/`article`/`general` — typed kinds (recipe/video/job) are detected automatically from schema.org
+- `enable_llm` has no effect when the page ships schema.org JSON-LD — the deterministic mapper wins for free
+- Tasks API is free and retains records for 7 days only
+- `cache_ttl_seconds: 0` means "do not cache" — use `bypass_cache` to skip read
+
+> **MCP:** `pip install mcp-webextrator` | Hosted: `https://webextrator.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)