npm - @acedatacloud/skills - Versions diffs - 2026.629.3 → 2026.630.1 - Mend

@acedatacloud/skills 2026.629.3 → 2026.630.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/package.json +1 -1
package/skills/ai-chat/SKILL.md +82 -137
package/skills/feishu/SKILL.md +239 -0
package/skills/fish-audio/SKILL.md +72 -37
package/skills/flux-image/SKILL.md +3 -1
package/skills/kling-video/SKILL.md +22 -1
package/skills/veo-video/SKILL.md +5 -5

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.629.3",
+  "version": "2026.630.1",
   "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/ai-chat/SKILL.md CHANGED Viewed

@@ -1,113 +1,81 @@
 ---
 name: ai-chat
-description: Access 50+ LLM models through a unified OpenAI-compatible API via AceDataCloud. Use when you need chat completions from GPT, Claude, Gemini, Kimi, Grok, or other models through a single endpoint. Supports streaming, function calling, and vision.
+description: Access 50+ LLM models through AceDataCloud's unified chat APIs. Use when you need OpenAI-compatible chat/responses calls or the newer `/aichat2/conversations` API across GPT, Claude, Gemini, Grok, Kimi, GLM, and DeepSeek models. Supports streaming, multimodal input, and tool calling.
 license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Works as a drop-in replacement for the OpenAI SDK.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Works with OpenAI-compatible SDKs against the `/openai/*` routes.
 ---
 # AI Chat — Unified LLM Gateway
-Access 50+ language models through a single OpenAI-compatible endpoint via AceDataCloud.
+AceDataCloud exposes two documented chat surfaces:
+| Endpoint | Use For |
+|----------|---------|
+| `POST /aichat2/conversations` | Recommended stateful / multimodal / agentic conversations |
+| `POST /aichat/conversations` | Legacy conversation endpoint |
+| `POST /openai/chat/completions` | OpenAI-compatible stateless chat completions |
+| `POST /openai/responses` | OpenAI-compatible responses API |
 > **Setup:** See [authentication](../_shared/authentication.md) for token setup.
 ## Quick Start
+### Recommended: stateful conversations
 ```bash
-curl -X POST https://api.acedata.cloud/v1/chat/completions \
-  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+curl -X POST https://api.acedata.cloud/aichat2/conversations \
+  -H "Authorization: ******ACEDATACLOUD_API_TOKEN" \
   -H "Content-Type: application/json" \
-  -d '{"model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "Hello!"}]}'
+  -d '{"model":"gpt-4.1","question":"Summarize the latest release notes.","stateful":true}'
 ```
-## OpenAI SDK Drop-in
+### OpenAI-compatible SDK
 ```python
 from openai import OpenAI
 client = OpenAI(
     api_key="your-token-here",
-    base_url="https://api.acedata.cloud/v1"
+    base_url="https://api.acedata.cloud/openai"
 )
 response = client.chat.completions.create(
-    model="gpt-4.1",
+    model="gpt-5.5",
     messages=[{"role": "user", "content": "Explain quantum computing"}]
 )
 print(response.choices[0].message.content)
 ```
-## Available Models
-### OpenAI GPT
-| Model | Type | Best For |
-|-------|------|----------|
-| `gpt-4.1` | Latest | General-purpose, high quality |
-| `gpt-4.1-mini` | Small | Fast, cost-effective |
-| `gpt-4.1-nano` | Tiny | Ultra-fast, lowest cost |
-| `gpt-4o` | Multimodal | Vision + text |
-| `gpt-4o-mini` | Small multimodal | Fast vision tasks |
-| `o1` | Reasoning | Complex reasoning tasks |
-| `o1-mini` | Small reasoning | Quick reasoning |
-| `o1-pro` | Pro reasoning | Advanced reasoning |
-| `gpt-5` | Latest gen | Next-gen intelligence |
-| `gpt-5.4` | Gen 5.4 | High-performance next-gen |
-| `gpt-5-mini` | Mini gen 5 | Fast next-gen |
-### Anthropic Claude
-| Model | Type | Best For |
-|-------|------|----------|
-| `claude-opus-4-8` | Latest Opus | Highest capability |
-| `claude-opus-4-6` | Latest Opus | Highest capability |
-| `claude-sonnet-4-6` | Latest Sonnet | Balanced quality/speed |
-| `claude-opus-4-5-20251101` | Opus 4.5 | Premium tasks |
-| `claude-sonnet-4-5-20250929` | Sonnet 4.5 | High-quality balance |
-| `claude-sonnet-4-20250514` | Sonnet 4 | Reliable general-purpose |
-| `claude-haiku-4-5-20251001` | Haiku 4.5 | Fast, efficient |
-| `claude-3-5-sonnet-20241022` | Legacy 3.5 | Proven track record |
-| `claude-3-opus-20240229` | Legacy Opus | Maximum quality (legacy) |
-### Google Gemini
-| Model | Best For |
-|-------|----------|
-| `gemini-1.5-pro` | Long context, complex tasks |
-| `gemini-1.5-flash` | Fast, efficient |
-### xAI Grok
-| Model | Best For |
-|-------|----------|
-| `grok-4` | Latest, highest capability |
-| `grok-3` | General-purpose |
-| `grok-3-fast` | Speed-optimized |
-| `grok-3-mini` | Compact, efficient |
-## Features
-### Streaming
+## Currently Documented Model Families
-```json
-POST /v1/chat/completions
-{
-  "model": "claude-sonnet-4-20250514",
-  "messages": [{"role": "user", "content": "Write a story"}],
-  "stream": true
-}
-```
+The OpenAPI specs expose a broad, fast-moving model catalog. Representative current
+models include:
+| Family | Current examples |
+|--------|------------------|
+| OpenAI / reasoning | `gpt-5.5`, `gpt-5.5-pro`, `gpt-5.4`, `gpt-5.4-pro`, `gpt-5.2`, `gpt-5.1`, `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-4o`, `gpt-4o-mini`, `o1`, `o3`, `o4-mini` |
+| OpenAI free-tier chat-completions | `gpt-5.5:free`, `gpt-5:free`, `gpt-4.1:free`, `gpt-4o:free`, `gpt-4o-mini:free`, `gpt-oss:free` |
+| Claude | `claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6`, `claude-opus-4-5-20251101`, `claude-sonnet-4-6`, `claude-sonnet-4-5-20250929`, `claude-sonnet-4-20250514`, `claude-haiku-4-5-20251001`, `claude-3-7-sonnet-20250219` |
+| Gemini | `gemini-3.1-pro`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-image-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3-pro-preview`, `gemini-2.5-flash-lite`, `gemini-2.0-flash-lite` |
+| Grok | `grok-4`, `grok-4-0709`, `grok-3`, `grok-3-fast` |
+| DeepSeek | `deepseek-r1`, `deepseek-r1-0528`, `deepseek-v3`, `deepseek-v3-250324`, `deepseek-v3.2-exp`, `deepseek-v4-flash` |
+| Kimi | `kimi-k2.5`, `kimi-k2-thinking-turbo`, `kimi-k2-thinking`, `kimi-k2-instruct-0905`, `kimi-k2-0905-preview`, `kimi-k2-turbo-preview`, `kimi-k2-0711-preview` |
+| GLM | `glm-5.2`, `glm-5.1`, `glm-5`, `glm-5-turbo`, `glm-4.7`, `glm-4.6`, `glm-4.5`, `glm-4.5v`, `glm-3-turbo` |
+`/aichat2/conversations` also accepts `model_group` values
+`chatgpt`, `claude`, `gemini`, `grok`, `kimi`, `glm`, and `deepseek`.
-### Function Calling
+## OpenAI-Compatible Chat
 ```json
-POST /v1/chat/completions
+POST /openai/chat/completions
 {
   "model": "gpt-4.1",
-  "messages": [{"role": "user", "content": "What's the weather in Tokyo?"}],
+  "messages": [{"role": "user", "content": "Write a haiku about observability."}],
+  "stream": true,
   "tools": [
     {
       "type": "function",
@@ -120,84 +88,61 @@ POST /v1/chat/completions
 }
 ```
-### Vision
-```json
-POST /v1/chat/completions
-{
-  "model": "gpt-4o",
-  "messages": [
-    {
-      "role": "user",
-      "content": [
-        {"type": "text", "text": "What's in this image?"},
-        {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
-      ]
-    }
-  ]
-}
-```
-## Parameters
+Common parameters:
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `model` | string | Model name (see tables above) |
-| `messages` | array | Array of `{role, content}` objects |
-| `temperature` | 0–2 | Randomness (default: 1) |
-| `top_p` | 0–1 | Nucleus sampling |
-| `max_tokens` | integer | Maximum output tokens |
+| `model` | string | One of the documented OpenAI-compatible models |
+| `messages` | array | Standard OpenAI chat message list |
+| `temperature` / `top_p` | number | Sampling controls |
+| `max_tokens` | integer | Output cap |
 | `stream` | boolean | Enable SSE streaming |
-| `tools` | array | Function calling definitions |
-| `tool_choice` | string/object | Tool selection strategy |
+| `tools` / `tool_choice` | array / string-object | Function-calling controls |
+| `service_tier` | string | Processing tier (`auto`, `default`, `flex`, `scale`, `priority`) |
+## Stateful / Agentic Conversations
-## Response
+`POST /aichat2/conversations` generalizes the legacy conversation API with
+multimodal user content, CRUD-style actions, and server-side conversation state.
 ```json
+POST /aichat2/conversations
 {
-  "id": "chatcmpl-xxx",
-  "object": "chat.completion",
-  "model": "claude-sonnet-4-20250514",
-  "choices": [
-    {
-      "index": 0,
-      "message": {"role": "assistant", "content": "Hello!"},
-      "finish_reason": "stop"
-    }
+  "action": "chat",
+  "model": "claude-sonnet-4-6",
+  "message": [
+    {"type": "text", "text": "Describe this image."},
+    {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
   ],
-  "usage": {
-    "prompt_tokens": 10,
-    "completion_tokens": 5,
-    "total_tokens": 15
-  }
+  "stateful": true,
+  "allowed_skills": ["google-search"],
+  "allowed_mcp_servers": ["mcp-google-search"]
 }
 ```
-## Gotchas
-- **100% OpenAI-compatible** — use the standard OpenAI SDK with `base_url="https://api.acedata.cloud/v1"`
-- Billing is token-based with per-model pricing (more expensive models cost more per token)
-- Vision is supported on multimodal models (`gpt-4o`, `gpt-4o-mini`, `grok-2-vision-*`)
-- Function calling works on most modern models (GPT-4+, Claude 3+)
-- Streaming returns `chat.completion.chunk` objects via SSE
-- `finish_reason` values: `"stop"` (complete), `"length"` (max tokens), `"tool_calls"` (function call), `"content_filter"` (filtered)
-## Stateful Conversations Endpoint
-For stateful, session-based chat (no need to send the full history each time), use `POST /aichat2/conversations` (recommended). `POST /aichat/conversations` remains available for legacy compatibility.
-```bash
-curl -X POST https://api.acedata.cloud/aichat2/conversations \
-  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"model": "gpt-4.1", "question": "What is quantum computing?", "stateful": true}'
-```
+Useful parameters:
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `model` | string | Model name (see Available Models above) |
-| `question` | string | The prompt or question to answer |
-| `id` | string | Conversation ID — pass the same ID to continue a session |
-| `preset` | string | Preset/system prompt for the conversation |
-| `stateful` | boolean | Enable stateful conversation (maintains history server-side) |
-| `references` | array | Additional context documents to include |
+| `action` | string | `chat`, `retrieve`, `retrieve_batch`, `update`, `delete` |
+| `model` | string | Model name |
+| `question` | string | Simple text prompt |
+| `message` | string or array | Multimodal content using `text`, `image_url`, or `file_url` items |
+| `stateful` | boolean | Keep conversation history server-side |
+| `references` | array | Extra context documents |
+| `preset` | string | Preset/system prompt |
+| `max_turns` | integer | Trim retained turn history |
+| `allowed_skills` / `allowed_mcp_servers` | array | Restrict tool-use scope |
+| `unattended_policy` | object | Tool-use permission policy |
+| `tool_results` | array | Return results for previously requested tool calls |
+| `model_group` | string | Family selector (`chatgpt`, `claude`, `gemini`, `grok`, `kimi`, `glm`, `deepseek`) |
+| `offset` / `limit` | integer | Pagination for retrieval actions |
+| `callback_url` / `async` | string / boolean | Async execution |
+## Gotchas
+- The documented OpenAI-compatible routes live under `/openai/*`, not `/v1/*`.
+- `POST /aichat2/conversations` is the recommended stateful endpoint; `POST /aichat/conversations` remains for legacy clients.
+- `message` on `/aichat2/conversations` can be multimodal (`text`, `image_url`, `file_url`); plain `question` still works for simple text prompts.
+- `action` on `/aichat2/conversations` is not chat-only — it also supports `retrieve`, `retrieve_batch`, `update`, and `delete`.
+- Free-tier model variants such as `gpt-5.5:free` are documented on `/openai/chat/completions`.

package/skills/feishu/SKILL.md ADDED Viewed

@@ -0,0 +1,239 @@
+---
+name: feishu
+description: Read and write Feishu (飞书) docs, sheets, Base (bitable), Drive files, calendar events, tasks, wiki, and IM messages via the Feishu Open Platform REST API. Use when the user mentions 飞书 / Feishu / Lark, a Feishu document or sheet link, their Feishu calendar, or wants to send a Feishu message.
+when_to_use: |
+  Trigger when the user wants to read or write something in Feishu (飞书) —
+  summarize / create / edit a doc, read or append to a spreadsheet, query
+  or add Base (bitable) records, browse Drive files, look at or create
+  calendar events, manage tasks, read wiki nodes, or send an IM message.
+connections: [feishu]
+allowed_tools: [Bash]
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+---
+We drive the [Feishu Open Platform API](https://open.feishu.cn/document)
+with `curl + jq`. The user's OAuth `user_access_token` is in
+`$FEISHU_TOKEN`; every call sends it as `Authorization: Bearer
+$FEISHU_TOKEN`. All endpoints live under `https://open.feishu.cn/open-apis`.
+Calls run **in the user's context** (their docs, calendar, messages) — only
+data the user can access and only the scopes they granted at connect time
+(docs / sheets / base / drive / calendar / IM / wiki / task / contacts).
+## Response shape & error handling
+Every Feishu response is `{"code": 0, "msg": "success", "data": {…}}`.
+**`code == 0` means success**; any non-zero `code` is an error — surface
+`msg` to the user. Always check it:
+```sh
+resp=$(curl -sS … )
+echo "$resp" | jq 'if .code == 0 then .data else error("Feishu \(.code): \(.msg)") end'
+```
+Common error codes:
+| code | meaning | what to do |
+|---|---|---|
+| `99991663` / `99991668` | access token invalid / expired | tell the user to reconnect Feishu in 连接 settings |
+| `99991661` | no permission (scope not granted) | the connect-time scope is missing — reconnect and grant it |
+| `1254xxx` | resource not found / no access | the user can't see that doc / sheet / app — double-check the token/id |
+## Recipes
+### Verify auth (always run first)
+```sh
+curl -sS https://open.feishu.cn/open-apis/authen/v1/user_info \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then {name: .data.name, open_id: .data.open_id, email: .data.email} else . end'
+```
+### Docs (docx)
+A Feishu doc URL looks like `https://…feishu.cn/docx/<document_id>`. The
+`document_id` is the last path segment.
+Read a document's plain text:
+```sh
+curl -sS "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/raw_content" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq -r 'if .code == 0 then .data.content else "ERR \(.code): \(.msg)" end'
+```
+List a document's blocks (structured content):
+```sh
+curl -sS "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/blocks?page_size=500" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {block_id, block_type}] else . end'
+```
+Create a new empty document (optionally inside a folder):
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/docx/v1/documents" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc --arg title "会议纪要 2026-07-01" '{title: $title}')" \
+  | jq 'if .code == 0 then {document_id: .data.document.document_id} else . end'
+```
+Append a text block to a document (insert at the end of the document body —
+`DOCUMENT_ID` is also the root block id):
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/blocks/DOCUMENT_ID/children" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc --arg text "由助手追加的一段内容。" '
+    {children: [{block_type: 2, text: {elements: [{text_run: {content: $text}}]}}]}')" \
+  | jq 'if .code == 0 then "appended" else . end'
+```
+### Spreadsheets (sheets v2)
+A sheet URL looks like `https://…feishu.cn/sheets/<spreadsheet_token>`.
+A range is `<sheetId>!<A1:range>`, e.g. `abc123!A1:D10`. List sheet ids via
+the metainfo endpoint first if you don't have one.
+Read a range:
+```sh
+curl -sS "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/SPREADSHEET_TOKEN/values/RANGE" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then .data.valueRange.values else . end'
+```
+Append rows after the last non-empty row:
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/SPREADSHEET_TOKEN/values_append" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc '{valueRange: {range: "SHEET_ID!A1:B1", values: [["张三", 100], ["李四", 200]]}}')" \
+  | jq 'if .code == 0 then .data.updates else . end'
+```
+### Base / 多维表格 (bitable v1)
+A Base URL looks like `https://…feishu.cn/base/<app_token>`. Get `table_id`
+from `…/bitable/v1/apps/APP_TOKEN/tables`.
+List records:
+```sh
+curl -sS "https://open.feishu.cn/open-apis/bitable/v1/apps/APP_TOKEN/tables/TABLE_ID/records?page_size=100" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {record_id, fields}] else . end'
+```
+Create a record:
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/bitable/v1/apps/APP_TOKEN/tables/TABLE_ID/records" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc '{fields: {"标题": "新任务", "状态": "待办"}}')" \
+  | jq 'if .code == 0 then {record_id: .data.record.record_id} else . end'
+```
+### Drive files
+List files in a folder (omit `folder_token` for the root):
+```sh
+curl -sS "https://open.feishu.cn/open-apis/drive/v1/files?folder_token=FOLDER_TOKEN&page_size=50" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.files[] | {name, type, token, url}] else . end'
+```
+### Calendar (v4)
+List the user's calendars (the primary one has `type: "primary"`):
+```sh
+curl -sS "https://open.feishu.cn/open-apis/calendar/v4/calendars?page_size=50" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.calendar_list[] | {calendar_id, summary, type}] else . end'
+```
+List events in a time window (epoch-seconds strings):
+```sh
+curl -sS "https://open.feishu.cn/open-apis/calendar/v4/calendars/CALENDAR_ID/events?start_time=1751299200&end_time=1751385600&page_size=100" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {summary, start: .start_time, end: .end_time, event_id}] else . end'
+```
+Create an event (times are epoch-seconds strings):
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/calendar/v4/calendars/CALENDAR_ID/events" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc '{summary: "项目评审", start_time: {timestamp: "1751302800"}, end_time: {timestamp: "1751306400"}}')" \
+  | jq 'if .code == 0 then {event_id: .data.event.event_id} else . end'
+```
+### Tasks (v2)
+List the user's tasks:
+```sh
+curl -sS "https://open.feishu.cn/open-apis/task/v2/tasks?page_size=50" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {summary, completed_at, task_guid: .guid}] else . end'
+```
+Create a task:
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/task/v2/tasks" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc '{summary: "准备周会材料"}')" \
+  | jq 'if .code == 0 then {task_guid: .data.task.guid} else . end'
+```
+### Wiki
+List wiki spaces, then nodes within a space:
+```sh
+curl -sS "https://open.feishu.cn/open-apis/wiki/v2/spaces?page_size=50" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {space_id, name}] else . end'
+curl -sS "https://open.feishu.cn/open-apis/wiki/v2/spaces/SPACE_ID/nodes?page_size=50" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  | jq 'if .code == 0 then [.data.items[] | {title, node_token, obj_type}] else . end'
+```
+### Send an IM message
+Send to a user by `open_id` (use `receive_id_type=chat_id` for a group
+chat). `content` must be a JSON **string**, so it's double-encoded:
+```sh
+curl -sS -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
+  -H "Authorization: Bearer $FEISHU_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -nc --arg rid "ou_xxx" --arg text "你好，这是助手发送的消息。" '
+    {receive_id: $rid, msg_type: "text", content: ({text: $text} | tostring)}')" \
+  | jq 'if .code == 0 then {message_id: .data.message_id} else . end'
+```
+## Notes
+- Confirm destructive or outward-facing actions (sending a message,
+  creating a calendar invite, posting to a shared doc) with the user
+  before running them.
+- Pagination: list endpoints return `data.page_token` / `data.has_more`;
+  pass `page_token=…` to fetch the next page.
+- When the user pastes a Feishu link, extract the token/id from the URL
+  path rather than asking them for it.

package/skills/fish-audio/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: fish-audio
-description: Generate AI text-to-speech audio and clone voices with Fish Audio via AceDataCloud API. Use when creating voiceover/narration audio (TTS), synthesizing speech, or cloning a reference voice. Chinese + multilingual.
+description: Generate AI text-to-speech audio with Fish Audio and browse public reference voices via AceDataCloud API. Use when creating voiceover/narration audio (TTS), synthesizing multilingual speech, or selecting a Fish reference voice from the model catalog.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -8,76 +8,111 @@ metadata:
 compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
-# Fish Audio — Text-to-Speech & Voice Cloning
+# Fish Audio — Text-to-Speech
-Generate narration / voiceover and clone voices through AceDataCloud's Fish Audio API.
+Generate narration / voiceover through AceDataCloud's Fish Audio API.
 > **Setup:** See [authentication](../_shared/authentication.md) for token setup.
-## Quick Start (TTS — synchronous, ~3s)
+## Quick Start
 ```bash
-curl -X POST https://api.acedata.cloud/fish/audios \
-  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+curl -X POST https://api.acedata.cloud/fish/tts \
+  -H "Authorization: ******ACEDATACLOUD_API_TOKEN" \
   -H "Content-Type: application/json" \
-  -d '{"action":"speech","model":"fish-tts","voice_id":"543e4181d81b4ef6874b0e8fbdf27c78","prompt":"你好,欢迎使用 AceData Cloud。"}'
+  -H "model: s2-pro" \
+  -d '{"text":"你好，欢迎使用 AceData Cloud。","reference_id":"d7900c21663f485ab63ebdb7e5905036","format":"mp3"}'
 ```
-Response (synchronous — no polling needed for `speech`):
+Synchronous responses return a direct audio URL:
 ```json
-{"success": true, "data": [{"audio_url": "https://platform.r2.fish.audio/task/....mp3"}]}
+{"audio_url":"https://platform.r2.fish.audio/task/8a72ff9840234006a9f74cb2fa04f978.mp3"}
 ```
-→ download `data[0].audio_url`. `voice_id` is **required**. A good default Mandarin
-news-anchor voice is **`543e4181d81b4ef6874b0e8fbdf27c78`**.
 ## Endpoints
 | Endpoint | Purpose |
 |----------|---------|
-| `POST /fish/audios` | TTS (`action: "speech"`) — synchronous |
-| `POST /fish/voices` | List / register (clone) voices |
+| `POST /fish/tts` | Text-to-speech generation |
+| `GET /fish/model` | Browse/search public Fish reference voices |
+| `POST /fish/tasks` | Poll async TTS jobs when `async: true` |
 ## Workflows
-### 1. Text-to-Speech (the common case)
+### 1. Find a reference voice
+```bash
+curl "https://api.acedata.cloud/fish/model?page_size=10&page_number=1&title=Marcus" \
+  -H "Authorization: ******ACEDATACLOUD_API_TOKEN"
+```
+The response includes `items[]` with public voice metadata such as `_id`, `title`,
+`languages`, `tags`, `visibility`, and `state`. Use an item `_id` as
+`reference_id` in TTS requests.
+### 2. Text-to-Speech
 ```json
-POST /fish/audios
+POST /fish/tts
+Headers:
+  model: s2-pro
 {
-  "action": "speech",
-  "model": "fish-tts",
-  "voice_id": "543e4181d81b4ef6874b0e8fbdf27c78",
-  "prompt": "你的旁白文本。"
+  "text": "Your narration text.",
+  "reference_id": "d7900c21663f485ab63ebdb7e5905036",
+  "format": "mp3"
 }
 ```
-### 2. Clone a voice from a reference sample
+### 3. Async TTS
 ```json
-POST /fish/voices
+POST /fish/tts
+Headers:
+  model: s1
 {
-  "voice_url": "https://example.com/reference-voice.mp3",
-  "title": "My Custom Voice",
-  "description": "Clear, neutral-toned speaker"
+  "text": "Longer narration for background processing.",
+  "async": true,
+  "callback_url": "https://api.acedata.cloud/health"
 }
 ```
-Then pass the returned id as `voice_id` in workflow 1.
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /fish/tasks` with `{"id":"..."}`.
+## Parameters — `/fish/tts`
+### Header
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `model` | `"s1"`, `"s2-pro"` | Fish TTS engine selection |
-## Parameters — `/fish/audios`
+### JSON body
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `action` | string | yes | Use `"speech"` for TTS |
-| `model` | string | yes | `"fish-tts"` |
-| `voice_id` | string | yes | A Fish reference/cloned voice id (default Mandarin: `543e4181d81b4ef6874b0e8fbdf27c78`) |
-| `prompt` | string | yes | Text to synthesize |
+| Parameter | Type / Values | Description |
+|-----------|---------------|-------------|
+| `text` | string | Text to synthesize (required) |
+| `reference_id` | string | Public/reference voice ID from `GET /fish/model` |
+| `format` | `"mp3"`, `"wav"`, `"pcm"`, `"opus"` | Output format |
+| `sample_rate` | integer | Optional output sample rate |
+| `mp3_bitrate` | `64`, `128`, `192` | MP3 bitrate |
+| `opus_bitrate` | integer | Opus bitrate |
+| `latency` | `"normal"`, `"balanced"` | TTS latency mode |
+| `chunk_length` / `min_chunk_length` | integer | Chunking controls |
+| `temperature`, `top_p`, `repetition_penalty` | number | Sampling controls |
+| `max_new_tokens` | integer | Maximum generated tokens |
+| `normalize` | boolean | Normalize generated audio |
+| `prosody` | object | Prosody tuning |
+| `references` | array | Additional reference objects |
+| `callback_url` | string | Async callback URL |
+| `async` | boolean | Run asynchronously and poll `/fish/tasks` |
 ## Gotchas
-- **TTS (`action:"speech"`) is synchronous** — the response carries `data[0].audio_url`; do NOT poll `/fish/tasks` for it.
-- `voice_id` is **required** — a bare `{"prompt": "..."}` returns `400 voice_id is required when action is speech`.
-- `model` must be `"fish-tts"` for speech (NOT `speech-1.5`); sending a different model returns `400 model is invalid if action is speech`.
-- Pricing is based on the **byte count** of the generated audio. Multilingual is automatic.
+- The documented TTS endpoint is `POST /fish/tts` — not `/fish/audios`.
+- Choose the Fish engine with the **`model` request header**, not a JSON `model` field.
+- Use `reference_id` from `GET /fish/model` — not `voice_id`.
+- Synchronous requests return `audio_url` directly; async jobs should be polled via `/fish/tasks`.
+- The current OpenAPI spec documents voice browsing via `GET /fish/model`; it does **not** document a voice-cloning write endpoint.

package/skills/flux-image/SKILL.md CHANGED Viewed

@@ -31,6 +31,7 @@ curl -X POST https://api.acedata.cloud/flux/images \
 |-------|---------|-------|-------|----------|
 | `flux-dev` | Good | Fast | 256–1440px | Quick generation (default) |
 | `flux-pro` | High | Medium | 256–1440px | Production work |
+| `flux-2-klein` | Good | Fastest | 256–1440px | Compact / lowest-latency Flux 2 generation |
 | `flux-2-flex` | High | Fast | 256–1440px | Faster high-quality generation |
 | `flux-2-pro` | Higher | Medium | 256–1440px | Better prompt following |
 | `flux-2-max` | Highest | Slow | 256–1440px | Maximum quality generation |
@@ -77,7 +78,8 @@ POST /flux/images
 - Use pixel dimensions (e.g., `"1024x1024"`) with dev/pro/flux-2 models, aspect ratios (e.g., `"16:9"`) with kontext models
 - Editing requires kontext models (`flux-kontext-pro` or `flux-kontext-max`) — other models only support generation
 - `count` parameter generates multiple images in one request (increases cost proportionally)
-- `flux-2-max` produces highest quality but is slowest — use dev/flex for iteration and max for final output
+- `flux-2-klein` is the lightest Flux 2 model — useful when latency matters more than peak quality
+- `flux-2-max` produces highest quality but is slowest — use dev/klein/flex for iteration and max for final output
 - All generation is async — always set `"callback_url"` to get a task id immediately, then poll `/flux/tasks` using `{"id":"<task_id>"}` or `{"ids":[...],"action":"retrieve_batch"}`
 > **MCP:** `pip install mcp-flux-pro` | Hosted: `https://flux.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/kling-video/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: kling-video
-description: Generate AI videos with Kuaishou Kling via AceDataCloud API. Use when creating videos from text or images, extending existing videos, applying motion control, or lip-syncing audio/text to video. Supports text-to-video, image-to-video, extend, motion generation, and lip-sync with multiple models and quality modes.
+description: Generate AI videos with Kuaishou Kling via AceDataCloud API. Use when creating videos from text or images, extending existing videos, applying motion control, animating a talking photo from image+audio, or lip-syncing audio/text to video. Supports text-to-video, image-to-video, extend, motion generation, talking-photo, and lip-sync with multiple models and quality modes.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -117,6 +117,21 @@ POST /kling/lip-sync
 }
 ```
+### 6. Talking Photo
+Animate a still portrait from an image plus an audio track.
+```json
+POST /kling/talking-photo
+{
+  "image_url": "https://example.com/portrait.jpg",
+  "audio_url": "https://example.com/voiceover.mp3",
+  "model": "kling-v2-1-master",
+  "duration": 5,
+  "mode": "pro"
+}
+```
 ## Parameters
 | Parameter | Values | Description |
@@ -143,6 +158,11 @@ POST /kling/lip-sync
 | `voice_id` (`/kling/lip-sync`) | string | Voice preset ID used in `text2video` |
 | `voice_language` (`/kling/lip-sync`) | `"zh"`, `"en"` | TTS language for `text2video` (default `zh`) |
 | `voice_speed` (`/kling/lip-sync`) | number | TTS speaking speed (default `1.0`) |
+| `image_url` (`/kling/talking-photo`) | URL | Source portrait image |
+| `audio_url` (`/kling/talking-photo`) | URL | Driving audio track |
+| `model` (`/kling/talking-photo`) | `"kling-v1"`, `"kling-v1-6"`, `"kling-v2-master"`, `"kling-v2-1-master"`, `"kling-v2-5-turbo"`, `"kling-v2-6"` | Talking-photo model |
+| `duration` (`/kling/talking-photo`) | `5`, `10` | Talking-photo duration |
+| `mode` (`/kling/talking-photo`) | `"std"`, `"pro"` | Talking-photo quality mode |
 ## Gotchas
@@ -152,6 +172,7 @@ POST /kling/lip-sync
 - `end_image_url` is only for `image2video` action — it defines the last frame
 - Motion control (`/kling/motion`) is a separate endpoint from video generation
 - Lip-sync is a separate endpoint (`/kling/lip-sync`) and requires `mode`; use `audio_url` for `audio2video` or `text` + voice fields for `text2video`
+- Talking-photo is a separate endpoint (`/kling/talking-photo`) and requires both `image_url` and `audio_url`
 - `pro` mode costs roughly 2x `std` mode but generates faster with better quality
 - Task states use `"succeed"` (not "succeeded") — check for this value when polling
 - `negative_prompt` helps avoid unwanted elements (e.g., "blurry, low quality, text")

package/skills/veo-video/SKILL.md CHANGED Viewed

@@ -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 2, Veo 3, and Veo 3.1 models including fast variants.
+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 2 Fast, Veo 3, and Veo 3.1 models including fast and ingredient variants.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -37,7 +37,6 @@ curl -X POST https://api.acedata.cloud/veo/tasks \
 | Model | Audio | Best For |
 |-------|-------|----------|
-| `veo2` | No | Cost-effective generation |
 | `veo2-fast` | No | Fast, cost-effective generation (default) |
 | `veo3` | Yes (native) | Full audiovisual generation |
 | `veo3-fast` | Yes (native) | Faster audiovisual generation |
@@ -69,7 +68,7 @@ POST /veo/videos
   "action": "image2video",
   "prompt": "the scene gently comes to life with wind and subtle motion",
   "image_urls": ["https://example.com/landscape.jpg"],
-  "model": "veo2",
+  "model": "veo2-fast",
   "aspect_ratio": "16:9"
 }
 ```
@@ -110,7 +109,7 @@ POST /veo/videos
 | `action` | `"text2video"`, `"image2video"`, `"ingredients2video"`, `"get1080p"` | Generation mode |
 | `model` | see Models table | Model to use (default: `veo2-fast`) |
 | `resolution` | `"4k"`, `"1080p"`, `"gif"` | Output resolution (default: 720p) |
-| `aspect_ratio` | `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"` | Aspect ratio — only valid for `image2video` |
+| `aspect_ratio` | `"16:9"`, `"9:16"` | Aspect ratio — only valid for `image2video` |
 | `image_urls` | array of strings | Reference image URLs — for `image2video` (up to 2) or `ingredients2video` (up to 3) |
 | `video_id` | string | Video to upscale — only for `get1080p` |
 | `translation` | `true` / `false` | Auto-translate prompt to English (default: false) |
@@ -206,11 +205,12 @@ POST /veo/objects
 ## Gotchas
-- Veo 3 and 3.1 models generate **native audio** — `veo2`/`veo2-fast` do NOT support audio
+- Veo 3 and 3.1 models generate **native audio** — `veo2-fast` does NOT support audio
 - The `get1080p` action uses `video_id` (from a prior generation), not a URL
 - `aspect_ratio` is **only valid** for the `image2video` action
 - `image_urls` accepts an array — up to 2 images for `image2video`, up to 3 for `ingredients2video`
 - `veo31-fast-ingredients` **requires** image input — it cannot do text-only generation
+- Documented `aspect_ratio` values are only `"16:9"` and `"9:16"`
 - `translation: true` auto-translates Chinese or other non-English prompts before sending to Veo
 - Task polling uses `id` (not `task_id`) in the `/veo/tasks` request body
 - Task states use `"succeeded"` (not "completed") — check for this value when polling