@acedatacloud/skills 2026.727.1 → 2026.727.3

package/package.json

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

@@ -0,0 +1,125 @@
+---
+name: dreamina-video
+description: Generate talking-photo digital human videos with Dreamina (ByteDance OmniHuman) via AceDataCloud API. Use when animating a portrait image with a driving audio track to produce a lip-synced video where the person speaks. Supports mask-based multi-person targeting and async task polling.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
+---
+
+# Dreamina Talking-Photo Video Generation
+
+Generate audio-driven digital human videos through AceDataCloud's Dreamina API (powered by ByteDance OmniHuman 1.5). Provide a portrait image and driving audio to produce a lip-synced talking-photo video.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/dreamina/videos \
+  -H "Authorization: ******" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "image_url": "https://example.com/portrait.jpg",
+    "audio_url": "https://example.com/voiceover.mp3",
+    "async": true
+  }'
+```
+
+The response contains a `task_id`. Poll for the result:
+
+```bash
+curl -X POST https://api.acedata.cloud/dreamina/tasks \
+  -H "Authorization: ******" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "retrieve", "id": "<task_id>"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll `POST /dreamina/tasks` until `response.data.status` equals `"done"`.
+
+## Model
+
+| Model | Description |
+|-------|-------------|
+| `omnihuman-1.5` | ByteDance OmniHuman 1.5 — audio-driven lip-sync digital human (default and only available model) |
+
+## Workflow
+
+### Basic Talking-Photo
+
+Generate a video where a portrait person speaks a given audio track.
+
+```json
+POST /dreamina/videos
+{
+  "model": "omnihuman-1.5",
+  "image_url": "https://example.com/portrait.jpg",
+  "audio_url": "https://example.com/speech.mp3",
+  "prompt": "Natural expression, steady head movement, warm tone",
+  "async": true
+}
+```
+
+### Multi-Person Mask
+
+To target a specific person in a group image, provide `mask_url` array with subject mask URLs.
+
+```json
+POST /dreamina/videos
+{
+  "image_url": "https://example.com/group-photo.jpg",
+  "audio_url": "https://example.com/speech.wav",
+  "mask_url": ["https://example.com/person-mask.png"],
+  "async": true
+}
+```
+
+## Parameters
+
+| Parameter | Required | Values | Description |
+|-----------|----------|--------|-------------|
+| `image_url` | ✓ | URL | Portrait image URL (public, clear frontal face works best) |
+| `audio_url` | ✓ | URL | Driving audio URL (mp3/wav, publicly reachable, keep under 60s) |
+| `model` | | `"omnihuman-1.5"` | Model to use (default: `omnihuman-1.5`) |
+| `prompt` | | string | Steers expression, emotion, stability, and style |
+| `mask_url` | | array of URLs | Subject mask URLs to target a specific person in a multi-person image |
+| `callback_url` | | URL | Webhook for result delivery |
+| `async` | | boolean | Return task ID immediately for polling |
+
+## Task Queries
+
+Retrieve one task:
+
+```json
+POST /dreamina/tasks
+{"action": "retrieve", "id": "<task_id>"}
+```
+
+You can also query by `trace_id`:
+
+```json
+POST /dreamina/tasks
+{"action": "retrieve", "trace_id": "<trace_id>"}
+```
+
+Retrieve several tasks:
+
+```json
+POST /dreamina/tasks
+{"action": "retrieve_batch", "ids": ["<id1>", "<id2>"]}
+```
+
+A completed response contains `response.data.video_url` when `response.data.status` is `"done"`.
+
+## Gotchas
+
+- Both `image_url` and `audio_url` are **required**
+- The portrait should be a clear, well-lit, front-facing image with the face unobstructed
+- Audio must be publicly reachable; keep it under 60s (≤30s recommended for 1080p quality)
+- Use `async: true` or `callback_url` for longer jobs — synchronous mode may time out
+- `mask_url` is only needed for multi-person images when you want to target one specific person
+- Check `response.data.status` when polling — the terminal state is `"done"`
+- Billed by output video duration
+
+> **MCP:** See [MCP servers](../_shared/mcp-servers.md) for tool-use integration.

package/skills/grok-video/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: grok-video
+description: Generate AI videos with Grok (xAI) via AceDataCloud API. Use when creating videos from text prompts or animating images using Grok's video generation models. Supports text-to-video and image-to-video with configurable resolution and aspect ratio.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
+---
+
+# Grok Video Generation
+
+Generate AI videos through AceDataCloud's Grok (xAI) API.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/grok/videos \
+  -H "Authorization: ******" \
+  -H "Content-Type: application/json" \
+  -d '{"prompt": "a futuristic city at night with flying cars and neon lights", "model": "grok-imagine-video-1.5-fast:reverse", "callback_url": "https://api.acedata.cloud/health"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /grok/tasks` with `{"id": "..."}`.
+
+## Models
+
+| Model | Resolution | Default | Notes |
+|-------|-----------|---------|-------|
+| `grok-imagine-video-1.5-fast:reverse` | up to 1080p | ✓ | Best value. 6–30s, billed by duration tier |
+| `grok-imagine-video:reverse` | up to 1080p | | Better value. 1–15s, billed per output second |
+| `grok-imagine-video:official` | up to 1080p | | Higher quality. 1–15s, billed per output second |
+| `grok-imagine-video-1.5:official` | up to 1080p | | Higher quality, **image-to-video only** (`image_url` required) |
+| `grok-imagine-video` | up to 720p | | Base model, text-to-video only |
+| `grok-imagine-video-1.5-preview` | up to 720p | | 1.5 preview (grok-video.json surface) |
+
+## Workflows
+
+### 1. Text-to-Video
+
+Generate a video from a text description.
+
+```json
+POST /grok/videos
+{
+  "prompt": "a majestic eagle soaring over snow-capped mountains at dawn",
+  "model": "grok-imagine-video-1.5-fast:reverse",
+  "resolution": "720p",
+  "aspect_ratio": "16:9",
+  "duration": 6
+}
+```
+
+### 2. Image-to-Video
+
+Animate a still image into motion. Provide the image URL via `image_url`.
+
+```json
+POST /grok/videos
+{
+  "prompt": "the eagle lifts off and flies into the sunset",
+  "image_url": "https://example.com/eagle.jpg",
+  "model": "grok-imagine-video:official",
+  "resolution": "720p",
+  "aspect_ratio": "16:9"
+}
+```
+
+### 3. Multi-Reference Generation
+
+Supply up to several reference images via `reference_image_urls` for style or subject consistency.
+
+```json
+POST /grok/videos
+{
+  "prompt": "the character walks through a cyberpunk alley",
+  "reference_image_urls": [
+    "https://example.com/character.jpg",
+    "https://example.com/style.jpg"
+  ],
+  "model": "grok-imagine-video-1.5-fast:reverse",
+  "resolution": "1080p"
+}
+```
+
+## Parameters
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `prompt` | string | Text description of the desired video |
+| `model` | see Models table | Model to use (default: `grok-imagine-video-1.5-fast:reverse`) |
+| `image_url` | URL | Single reference image for image-to-video |
+| `reference_image_urls` | array of URLs | Multiple reference images for style/subject guidance |
+| `aspect_ratio` | `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"3:2"`, `"2:3"` | Output aspect ratio |
+| `resolution` | `"480p"`, `"720p"`, `"1080p"` | Output resolution (default: `480p`; `1080p` only for `:reverse`/`:official` models) |
+| `duration` | integer | Duration in seconds (default: 6) |
+| `callback_url` | URL | Webhook URL for async delivery |
+| `async` | boolean | Return a task ID immediately for polling |
+
+## Task Queries
+
+```json
+POST /grok/tasks
+{"id": "<task_id>", "action": "retrieve"}
+```
+
+Batch retrieval:
+
+```json
+POST /grok/tasks
+{"ids": ["<id1>", "<id2>"], "action": "retrieve_batch"}
+```
+
+## Gotchas
+
+- `1080p` resolution is only supported by `:reverse` and `:official` model variants
+- `image_url` provides a single driving image; `reference_image_urls` provides multiple style/subject references
+- Set `callback_url` to get the task ID immediately without blocking on completion
+- Poll `POST /grok/tasks` with `{"id": "..."}` until a final video URL appears in the response
+
+> **MCP:** See [MCP servers](../_shared/mcp-servers.md) for tool-use integration.

package/skills/seedance-video/SKILL.md

@@ -170,7 +170,6 @@ POST /seedance/videos
 | `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 |
-| `service_tier` | `"default"`, `"flex"` | Processing tier (default: default) |
 | `execution_expires_after` | number | Task timeout threshold in seconds |
 
 ## Inline Parameter Syntax
@@ -193,7 +192,6 @@ Supported inline params: `--rs` (resolution), `--rt` (ratio), `--dur` (duration)
 - 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
-- `service_tier` values are `"default"` and `"flex"` (not "standard"/"premium")
 - 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
 

package/skills/turnstile/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: turnstile
+description: Solve Cloudflare Turnstile CAPTCHAs via AceDataCloud API. Use when you need to bypass or solve a Cloudflare Turnstile challenge by providing the site key and page URL to get back a valid token. Supports synchronous and asynchronous modes.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
+---
+
+# Cloudflare Turnstile CAPTCHA Solver
+
+Solve Cloudflare Turnstile CAPTCHA challenges through AceDataCloud's captcha API. Submit the site key and target URL to receive a valid `cf-turnstile-response` token.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/captcha/token/turnstile \
+  -H "Authorization: ******" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "website_key": "0x4AAAAAAADnPIDROrmt1Wwj",
+    "website_url": "https://react-turnstile.vercel.app"
+  }'
+```
+
+A successful synchronous response:
+
+```json
+{
+  "token": "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM...",
+  "started_at": "2026-07-24T09:34:13+00:00",
+  "finished_at": "2026-07-24T09:34:25+00:00",
+  "elapsed": 12.4
+}
+```
+
+Use the returned `token` as the `cf-turnstile-response` value when submitting forms to the target site. The token is single-use with a ~120s validity — use it within 60s.
+
+## How to Find `website_key`
+
+1. Open the target page in a browser and press F12 to open DevTools
+2. In the Elements panel, search for `cf-turnstile`
+3. Find the container element — the `data-sitekey` attribute value is the `website_key`
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `website_key` | ✓ | The Turnstile site key (`data-sitekey`) from the target page |
+| `website_url` | ✓ | The full URL of the page containing the Turnstile widget |
+| `action` | | Custom `action` value — only needed when the target page sets a custom action |
+| `cdata` | | Custom `cData` value — only needed when the target page sets a custom cData |
+| `async` | | When `true`, return immediately with a `task_id`; poll `POST /captcha/tasks` to retrieve the token |
+
+## Response Fields
+
+| Field | Description |
+|-------|-------------|
+| `token` | The solved Turnstile token to submit as `cf-turnstile-response` |
+| `started_at` | ISO-8601 timestamp when solving began |
+| `finished_at` | ISO-8601 timestamp when solving completed |
+| `elapsed` | Total solving time in seconds |
+
+## Async Mode
+
+Pass `async: true` to return a `task_id` immediately instead of blocking:
+
+```json
+POST /captcha/token/turnstile
+{
+  "website_key": "0x4AAAAAAADnPIDROrmt1Wwj",
+  "website_url": "https://react-turnstile.vercel.app",
+  "async": true
+}
+```
+
+Then poll `POST /captcha/tasks` with the returned `task_id`:
+
+```json
+POST /captcha/tasks
+{"id": "<task_id>"}
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md) for the full polling contract.
+
+## Using the Token
+
+Submit the token to the target site as `cf-turnstile-response`:
+
+```python
+import requests
+
+token = "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM..."
+response = requests.post(
+    "https://react-turnstile.vercel.app",
+    data={"cf-turnstile-response": token}
+)
+```
+
+## Gotchas
+
+- Both `website_key` and `website_url` are **required**
+- The token is single-use and valid for ~120s — use within 60s for best results
+- `action` and `cdata` are optional and only required when the target site explicitly uses them
+- You are billed only when a token is successfully solved
+- Synchronous mode blocks until the token is ready (typically 10–30s); use `async: true` for non-blocking operation
+
+> **MCP:** See [MCP servers](../_shared/mcp-servers.md) for tool-use integration.

package/skills/veo-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: veo-video
-description: Generate AI videos with Google Veo via AceDataCloud API. Use when creating videos from text descriptions, animating still images into video, upscaling/extending videos, re-shooting with new camera motion, or inserting/removing objects. Supports Veo 3 and Veo 3.1 models including fast and ingredient variants.
+description: Generate AI videos with Google Veo via AceDataCloud API. Use when creating videos from text descriptions, animating still images into video, blending reference images into video, or upscaling existing videos to 1080p. Supports Veo 3 and Veo 3.1 models including fast and ingredient variants.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -113,29 +113,6 @@ POST /veo/videos
 | `video_id` | string | Video to upscale — only for `get1080p` |
 | `translation` | `true` / `false` | Auto-translate prompt to English (default: false) |
 
-## Post-Generation Endpoints
-
-After generating a video, use these endpoints to further process it:
-
-### Extend (`POST /veo/extend`)
-
-Continue an existing video — AI auto-generates the next segment.
-
-```json
-POST /veo/extend
-{
-  "video_id": "your-video-id",
-  "model": "veo31-fast",
-  "prompt": "the camera slowly zooms out"
-}
-```
-
-| Parameter | Values | Description |
-|-----------|--------|-------------|
-| `video_id` | string | **Required.** Task ID from `/veo/videos` or a prior `/veo/extend` |
-| `model` | `"veo31-fast"`, `"veo31"` | **Required.** Only Veo 3.1 series is supported |
-| `prompt` | string | Optional: guides the extended segment |
-
 ## Gotchas
 
 - Veo 3 and 3.1 models generate **native audio**