静觅 崔庆才的个人站点 - Python爬虫教程

列出当前账户已签发的全部 API 凭证（Credential）——也就是调用 https://api.acedata.cloud/** 业务接口时用的 32 位 Token。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。

API 凭证 vs 账户令牌

新手最容易混淆——再强调一次：

详见管理 AceDataCloud 平台账户令牌。

接口概览

鉴权说明（如何获取账户令牌）

请求头：

1

Authorization: Bearer platform-v1-92eb****629c

获取方式：登录 AceDataCloud 平台 → Account Token 控制台 → 点击「创建」按钮。详见管理 AceDataCloud 平台账户令牌。

必传查询参数

⚠️ 必须带 ?user_id=<your_user_id>。列表接口逐对象做权限校验，没传时第一个非己对象就会返回 403 permission_denied。

获取 user_id：打开 https://auth.acedata.cloud/user/profile。

查询参数

请求示例

cURL

1
2
3
4

USER_ID=89518d07-5560-4b05-92c1-667f3ddf6a4b
curl "https://platform.acedata.cloud/api/v1/credentials/?user_id=${USER_ID}&limit=20" \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

import requests

PLATFORM_TOKEN = "platform-v1-92eb****629c"
USER_ID = "89518d07-5560-4b05-92c1-667f3ddf6a4b"

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/credentials/",
    headers={
        "accept": "application/json",
        "authorization": f"Bearer {PLATFORM_TOKEN}",
    },
    params={"user_id": USER_ID, "limit": 100},
    timeout=10,
)
data = resp.json()
print(f"共 {data['count']} 枚凭证")
for c in data["items"]:
    print(f"  {c['name']:30s}  {c['token'][:8]}...{c['token'][-4:]}  上次使用: {c.get('used_at') or '从未'}")

Node.js

1
2
3
4
5
6
7
8

const USER_ID = '89518d07-5560-4b05-92c1-667f3ddf6a4b'
const url = new URL('https://platform.acedata.cloud/api/v1/credentials/')
url.searchParams.set('user_id', USER_ID)

const r = await fetch(url, {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

响应示例（HTTP 200）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{
  "count": 5,
  "items": [
    {
      "id": "df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6",
      "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
      "application_id": "82f57141-2323-4453-8730-60f7d833a2da",
      "name": "production-server-01",
      "token": "ac****ab",
      "amount": null,
      "used_amount": 12.34,
      "remaining_amount": null,
      "disabled": false,
      "expired_at": null,
      "tags": ["prod"],
      "metadata": null,
      "client_ip_allowlist": null,
      "used_at": "2026-04-26T08:30:00Z",
      "created_at": "2026-04-26T07:55:00Z",
      "updated_at": "2026-04-26T08:30:00Z"
    }
  ]
}

⚠️ 列表接口的 token 字段是脱敏的（前 2 + **** + 后 2 字符）。需要完整 Token 时请到创建 AceDataCloud 平台 API 凭证接口在创建当时保存。如果忘了保存只能轮换或删除重建。

响应字段说明

错误处理

实用提示

• token 脱敏不可逆——只有在创建或轮换那一刻完整明文返回一次，请务必当场存进密码管理器。
• 生产环境强烈推荐设 amount 限额：通过创建凭证时指定，可避免凭证泄露后被无限制扣费。
• 僵尸凭证清理：used_at 为 null 或长时间未更新的，可以批量删除。

相关接口

• 创建 AceDataCloud 平台 API 凭证
• 删除 AceDataCloud 平台 API 凭证
• 轮换 AceDataCloud 平台 API 凭证
• 获取 AceDataCloud 平台 API 调用记录

Safety defaults

• EmailDeliveryControl.sending_enabled defaults to false in PostgreSQL.
• EMAIL_MARKETING_ALLOW_REAL_RECIPIENTS defaults to false.
• The worker claims no recipients unless both controls permit delivery.
• Test-only mode claims only normalized addresses in EMAIL_MARKETING_TEST_RECIPIENTS.
• Do not reuse verification SMTP credentials or send to real users during rollout.

Tencent SES setup

The sender identity is mailer.acedata.cloud in ap-hongkong. DNS must pass all four Tencent checks:

• MX for mailer.acedata.cloud
• SPF TXT for mailer.acedata.cloud
• DKIM TXT for qcloudhk1024._domainkey.mailer.acedata.cloud
• DMARC TXT for _dmarc.mailer.acedata.cloud

The sender address is news@mailer.acedata.cloud. Campaign templates are created from locked campaign content in the admin console and must be approved by Tencent before scheduling.

Event callback

Tencent SES does not expose callback configuration through its public API. Configure it in the Tencent SES console only after the backend route is deployed.

Retrieve the callback URL without committing or copying the secret into source files:

1
2
3

KUBECONFIG=/path/to/hk-kubeconfig
CALLBACK_PATH=$(kubectl --kubeconfig "$KUBECONFIG" -n acedatacloud get secret email-marketing -o jsonpath='{.data.EMAIL_MARKETING_CALLBACK_PATH_SECRET}' | base64 --decode)
printf 'https://platform.acedata.cloud/api/v1/email-marketing/events/tencent/%s/\n' "$CALLBACK_PATH"

Register that HTTPS URL for SES delivery events. Then mark the registration complete and restart only the affected workloads:

1
2
3
4

kubectl --kubeconfig "$KUBECONFIG" -n acedatacloud patch secret email-marketing --type merge \
  -p "$(printf '{\"stringData\":{\"EMAIL_MARKETING_CALLBACK_REGISTERED\":\"true\"}}')"
kubectl --kubeconfig "$KUBECONFIG" -n acedatacloud rollout restart deployment/platform-backend
kubectl --kubeconfig "$KUBECONFIG" -n acedatacloud rollout restart deployment/platform-backend-email-worker

Scheduling fails closed until provider health reports the identity enabled, callback registered, and every campaign template approved.

Seed rollout

1. Keep EMAIL_MARKETING_ALLOW_REAL_RECIPIENTS=false.
2. Keep exactly the owner-approved seed addresses in EMAIL_MARKETING_TEST_RECIPIENTS.
3. Refresh audience profiles and create a campaign using a narrow preset.
4. Lock content, preview and freeze the audience, then create Tencent templates.
5. Wait for both locale templates to be approved.
6. Enable the database control with the typed test confirmation.
7. Release only the canary wave and verify callbacks, delivery, unsubscribe, and suppression behavior.
8. Disable the database control after the test.

Moving to real recipients requires a separate owner decision, changing the deployment secret to EMAIL_MARKETING_ALLOW_REAL_RECIPIENTS=true, restarting the workloads, and using the stronger typed confirmation shown by the admin API.

Recovery

• Pause globally first by setting EmailDeliveryControl.sending_enabled=false in the admin console.
• reconcile_email_delivery recovers expired leases and never retries a provider request with an ambiguous outcome.
• Ambiguous sends become OutcomeUnknown after the reconciliation window and require manual review.
• Provider/user suppressions cannot be manually deactivated; only ManualSafety suppressions can be removed with an audit reason.
• Recipient PII is purged after the configured retention period; hashes and aggregate delivery records remain for safety and reporting.

本文将介绍 Veo Upsample API 的对接说明。该接口用于对一段已经生成的 Veo 视频进行升采样或者输出动图预览。

申请流程

要使用 API，需要先到 Veo 服务对应页面申请。如果你尚未登录或注册，会自动跳转到登录页面。

基本使用

调用本接口需要传入两个参数：

• video_id：来源视频的任务 ID。可以是 /veo/videos、/veo/extend、/veo/reshoot、/veo/objects 任意接口生成的视频 ID。
• action：升采样动作，支持以下三种：
  • 1080p：把视频升采样到 1080p 分辨率。
  • 4k：把视频升采样到 4K 分辨率。
  • gif：把视频转换为动图（GIF）预览。

请求示例：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/veo/upsample' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
    "action": "4k"
  }'

返回结果与 /veo/videos 相同，仍然是异步任务结构，可以通过 task_id 在 /veo/tasks 接口查询任务状态：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "success": true,
  "task_id": "8f5a90ae-3f86-4c4f-86f7-7126f5e92c76",
  "trace_id": "0f3e09c2-4c2e-46ea-9cdc-a31ec48b7c12",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/veo/8f5a90ae.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

返回字段说明：

• success：升采样任务是否提交成功。
• task_id：本次升采样任务的 ID。
• data：升采样后的视频结果。
  • video_url：升采样后的视频地址。

计费说明

• action=1080p：0.16 Credit / 次
• action=4k：0.50 Credit / 次
• action=gif：0.13 Credit / 次

如果传入的 action 不在以上枚举内，会被默认计费为 0.50 Credit。建议显式传入支持的值。

异步回调

接口同样支持异步模式，传入 callback_url 即可在任务完成后通过 POST 请求回调结果。若无公网回调地址，也可将 async 设为 true，接口同样立即返回 task_id，随后通过对应的任务查询接口轮询获取结果。

无论你在做舆情监测、价格比价、内容采集、站点巡检还是多地域可用性测试，IP 都是第一道门槛。频繁、集中、异常的请求，极易被系统识别并封禁。Ace Data Cloud 的 ADSL 轮换代理服务，提供来自移动/联通/电信等真实拨号线路的海量出口 IP，天然更接近真实用户画像，显著降低封禁率，让你的数据流程稳定“过白”。

关键链接

• 服务页（申请/Acquire）：https://platform.acedata.cloud/services/adsl
• 网关与端口：adsl.proxy.acedata.cloud:30005

可视化引导与控制台示意

• 申请页面：
• 控制台查看申请记录：
• 查看用户名/密码凭证：

为什么是 ADSL 轮换代理

• 真实居民网络：非机房段，贴近日常用户行为特征，更难被识别为“机器人”。
• 规模庞大：覆盖国内百余城市，每日数十万级出口 IP，避免小池子反复命中。
• 使用简单：固定网关与端口，账号密码即可走代理；HTTP/HTTPS/SOCKS 全支持。
• 按量计费：控制成本，先拿免费额度验证，再按需扩容。

适合什么场景

• 舆情与合规监测：稳定抓取公开页面，降低频繁封 IP 的概率；
• 价格与竞品比对：多地域请求更真实，数据更接近用户端所见；
• 站点巡检与 A/B：模拟真实访问路径，监控不同省市的体验差异；
• 账号分发运营：降低同源特征，减少风控触发（请遵守各平台政策与法律法规）。

接入 3 步走

1. 申请开通：在 Ace Data Cloud 平台进入 ADSL 代理服务，点击 Acquire 获取凭证（通常附带免费额度）。
2. 设置代理：固定网关 adsl.proxy.acedata.cloud 与端口 30005，填入分配的 8 位用户名与 32 位密码。
3. 开始请求：在爬虫/脚本/服务中设置 HTTP/HTTPS/SOCKS 代理，即刻生效。

示例（curl）：

1

curl -x <username>:<password>@adsl.proxy.acedata.cloud:30005 https://ipinfo.io

示例（Python requests）：

1
2
3
4
5

proxies = {
  'http': 'http://<username>:<password>@adsl.proxy.acedata.cloud:30005',
  'https': 'http://<username>:<password>@adsl.proxy.acedata.cloud:30005'
}
requests.get('https://ipinfo.io', proxies=proxies)

更多语言快速接入

• Node.js（axios + Proxy-Authorization）

1
2
3
4
5
6
7
8
9
10
11
12

const axios = require('axios');
const base64 = (s) => Buffer.from(s).toString('base64');
const host = 'adsl.proxy.acedata.cloud';
const port = '30005';
const user = '<username>'; // 8位
const pass = '<password>'; // 32位
axios.get('https://ipinfo.io', {
  proxy: false,
  headers: { 'Proxy-Authorization': `Basic ${base64(`${user}:${pass}`)}` },
  httpAgent: new (require('http-proxy-agent'))(`http://${host}:${port}`),
  httpsAgent: new (require('https-proxy-agent'))(`http://${host}:${port}`)
}).then(res => console.log(res.data));

和你的数据栈无缝衔接

• 多语言、多框架：requests、axios、Java/Go/Node……全家桶平滑对接；
• 可观测更友好：支持 Proxy-Authorization 头与固定网关配置，便于分层与排错；
• 安全与合规：账号级隔离与额度可控，方便审计与限流策略。

小贴士：稳定性的三个关键

• 合理并发：根据目标站点与任务类型设置请求间隔与并发上限；
• UA 与行为：模拟真实 UA、Referer 与滚动行为，降低反爬信号；
• 本地缓存：对稳定内容做缓存与增量抓取，减少不必要请求。

现在就让数据顺利回家

进入 Ace Data Cloud 平台，开通 ADSL 轮换代理。让每一次请求都更像“真实用户”，给你的增长与风控留出更大的操作空间。

SUNO 允许我们创建新版的Persona-v2-vox 版:歌手风格，与旧版本不同的需要先获取vox_audio_id。本文档讲解创建新版Persona-v2-vox的 对接方法。

首选需要该 API获取vox_audio_id参数值， 该API可以输入多个个输入参数，比如 audio_id、vocal_start、vocal_end，它是参考歌曲ID以及选定的时间范围。

这里我们输入的 audio_id 是 42599b24-fb14-4cd3-a444-e15ffde3661b。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

import requests

url = "https://api.acedata.cloud/suno/vox"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "audio_id": "42599b24-fb14-4cd3-a444-e15ffde3661b",
    "vocal_end": 30,
    "vocal_start": 20
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

{
  "success": true,
  "task_id": "9d5ce870-18e3-4c17-a1d9-7ef5a07918e9",
  "trace_id": "c31b50cd-0dbe-4e53-a7a5-83965dc5ad6b",
  "data": {
    "id": "24f0827e-5847-4011-b9b7-fc0b62032b65",
    "source_clip_id": "42599b24-fb14-4cd3-a444-e15ffde3661b",
    "status": "complete",
    "vocal_audio_url": "https://cdn1.suno.ai/processed_24f0827e-5847-4011-b9b7-fc0b62032b65_vocals.m4a",
    "vocal_end_s": 30,
    "vocal_start_s": 20,
    "wave_response": {
      "waveform_aggregates": [
        {
          "data": [
            [
              -4,
              4,
              -50,
              73,
              -2517,
              2887,
              
              294
            ],
            [
              -5,
              4,
              296
            ]
          ],
          "mip_map_level": 11
        },
       
        {
          "data": [
            [
              -19576,
              20406,
              -16717,
              16980,
              -18926,
              20807,
              -20029,
              20103,
              -16437,
              20899
            ],
            [
              -19578,
              20406,
              -16720,
              16980,
              -18825,
              20051,
              -20029,
              20103,
              -16453,
              20903
            ]
          ],
          "mip_map_level": 20
        }
      ]
    }
  }
}

可以看到，data 的 id 字段就是我们想要的vox_audio_id，然后我们去Persona API创建新版的Persona-v2-vox:歌手风格，具体输入如下所示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

import requests

url = "https://api.acedata.cloud/suno/persona"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "name": "test",
    "audio_id": "42599b24-fb14-4cd3-a444-e15ffde3661b",
    "vocal_end": 30,
    "vocal_start": 20,
    "vox_audio_id": "24f0827e-5847-4011-b9b7-fc0b62032b65"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

调用后得到如下结果：

1
2
3
4
5
6
7

{
  "success": true,
  "task_id": "e04b06a1-ff61-48e2-9fcc-15284bd18481",
  "data": {
    "persona_id": "49bef16d-6a09-49d1-8c24-a81663698b98"
  }
}

然后我们可以根据上面的persona_id值进行新版的Persona-v2-vox:歌手风格进行创作，具体的创作方法和Suno 歌曲生成 API 对接说明一致，最后我们就可以通过Suno Vox API来实现新版的Persona-v2-vox:歌手风格进行创作歌曲。

OpenCode 本身擅长读代码、改文件、跑命令、解释报错；MCP 则让它在同一个终端会话里继续调用外部工具。AceData Cloud 把音乐、图片、视频、搜索、短链这些能力做成托管式远程 MCP Server，你不需要本地启动服务，也不需要为每个工具维护不同账号。

这篇是总览入口，重点帮你判断：OpenCode MCP 能做什么、该先接哪个服务、每个服务的详细教程在哪里。具体配置写法、Token 获取、global / project 两种位置的差异，放在下面每篇单服务文章里展开。

如果你的 OpenCode 还不能正常调用模型，请先看 OpenCode 终端配置教程。如果你想直接对接 Claude Code 而不是 OpenCode，请看 Claude Code MCP 总览。

为什么要在 OpenCode 里接 MCP

OpenCode 是完全开源的终端编程 Agent，它的强项是”原生终端体验 + 任意模型可换”。接入 MCP 之后，它可以把”写完代码 → 补 README 配图 → 做发布素材 → 查参考资料 → 压短链分享”这一长串本来需要切换浏览器和工具的工作，全部在终端会话里完成。

和 IDE 类工具相比，OpenCode 更适合：

• SSH 远程开发场景（无 GUI 也能完整使用 MCP）
• 用脚本/CI 把 MCP 调用拼接进自动化流程
• 喜欢键盘流、不希望被插件挡住屏幕的工程师

AceData Cloud 提供哪些 MCP Server

一个 AceData Cloud API Token 可以使用以下全部 MCP Server。你可以只接一个，也可以按工作流组合多个。

上表的「工具数」是 2026-05-31 用 opencode mcp list + JSON-RPC tools/list 实测得到，10 个 MCP Server 共暴露 109 个工具。

推荐怎么选

如果你只是想先确认 MCP 能跑通，建议从 Google 搜索 MCP 或 ShortURL MCP 开始：调用快、结果直观、成本低。做内容和营销素材时，可以从 Flux / Seedream / Midjourney 里选一个图像服务；需要视频时再接 Luma / Veo / Seedance；需要音乐或 BGM 时接 Suno。

配置在哪里写

OpenCode 用同一份 opencode.json 描述供应商和 MCP。两种位置只是优先级不同：

• 全局：~/.config/opencode/opencode.json，所有项目共用，适合”我自己的机器，一次配好”。
• 项目级：当前项目根目录下的 opencode.json，仅对该项目生效，会覆盖全局，适合团队共享或单仓库定制。

无论放在哪里，结构都是相同的，每个服务一段 mcp.<name> 配置：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shorturl": {
      "type": "remote",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:ACEDATACLOUD_API_KEY}" }
    }
  }
}

字段说明：

{env:ACEDATACLOUD_API_KEY} 让 OpenCode 在启动时从环境变量里读取 Token，避免把真实 Token 直接写入文件。建议在 ~/.zshrc / ~/.bashrc 里 export ACEDATACLOUD_API_KEY="你的Token"。如果 Token 写在没有 export 的 .env 文件里，需要用 set -a && source .env && set +a 把它导出到 OpenCode 进程，否则 opencode debug config 会显示 "Authorization": "Bearer "（占位符未解析）。

配置示例里不会写完整 Token，只会用类似 357265014ad145fc8ab2.... 的形式展示。真实 Token 请只保存在你本机配置或私有环境变量中。

真实连通性验证

以下结果来自 OpenCode 1.15.13，在隔离临时目录中把 10 个 AceData MCP 同时写入 opencode.json，再运行 opencode mcp list 得到。Token 已脱敏（357265014ad145fc8ab2....），临时配置已删除。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

$ opencode --version
1.15.13

$ opencode mcp list

┌  MCP Servers
│
●  ✓ suno connected
│      https://suno.mcp.acedata.cloud/mcp
●  ✓ midjourney connected
│      https://midjourney.mcp.acedata.cloud/mcp
●  ✓ flux connected
│      https://flux.mcp.acedata.cloud/mcp
●  ✓ seedream connected
│      https://seedream.mcp.acedata.cloud/mcp
●  ✓ nanobanana connected
│      https://nanobanana.mcp.acedata.cloud/mcp
●  ✓ luma connected
│      https://luma.mcp.acedata.cloud/mcp
●  ✓ veo connected
│      https://veo.mcp.acedata.cloud/mcp
●  ✓ seedance connected
│      https://seedance.mcp.acedata.cloud/mcp
●  ✓ serp connected
│      https://serp.mcp.acedata.cloud/mcp
●  ✓ shorturl connected
│      https://shorturl.mcp.acedata.cloud/mcp
│
└  10 server(s)

调试单个 MCP 连接：

1

opencode mcp debug shorturl

选模型的实测建议

要在 OpenCode 中真正”对话 + 调用 MCP 工具”两件事一起做，模型选择有讲究。下面是用 AceData Token 实际测试得到的结论：

已知限制：当 opencode.json 中同时启用多个 MCP 时，Claude 系列模型容易在上游返回 Improperly formed request。原因是部分 MCP 工具的 JSON Schema（anyOf 等用法）超出了 Anthropic 接口的严格校验范围。要让 Claude 同时对话 + 调用工具，建议先在 opencode.json 中把暂时不用的 MCP 的 enabled 改成 false，只保留必要的几个；或者直接换成 OpenAI 系列模型作为对话模型。

常见工作流

终端里写 README 顺手生图

让 OpenCode 先读懂你新功能的 README 草稿，再调用 Midjourney / Flux / Seedream 生成 banner，最后把图片 URL 直接贴回 README。

远程服务器排查问题 + 搜资料

SSH 到服务器后启动 opencode，让它结合本地日志和 Google 搜索 MCP 找到匹配的社区帖子或 issue，再用 ShortURL MCP 把相关链接压成短链发到群里。

发版素材一条龙

让 OpenCode 根据 CHANGELOG 用 Suno 写一段 30 秒 BGM、用 Veo 生成预览视频、用 Flux 出一张主视觉，整个过程不离开终端。

下一步

从上面的表格里选一个服务进入单独教程，先在项目 opencode.json 里跑通单服务。确认 opencode mcp list 显示 ✓ connected 后，再决定是否把它升级到全局 ~/.config/opencode/opencode.json，让所有项目都能直接调用。

相关链接

• OpenCode 官方文档
• OpenCode 配置参考
• OpenCode 终端配置教程
• 所有 MCP Server 列表
• REST API 文档

📘 Overview：OpenCode MCP Overview →

Seedance 在“短视频 / 竖屏素材 / 动作演绎”上的表现尤其稳定，可以一次性给出带音频的成片，非常适合直接用作社交媒体素材。在 OpenCode 里接上 Seedance MCP Server 后，可以从需求一句话直接出动效视频，省去剪辑、配音的中间步骤。

Seedance MCP 适合做 Reels / 抖音 / 小红书短视频、产品 demo 动效、技术分享开场片头等“短而有冲击力”的视频场景。

获取 API Token

使用 Seedance MCP Server 之前，需要先准备一个 Ace Data Cloud API Token。OpenCode 和 Claude Code 共用一套 Token，获取流程一样：

1. 打开 Ace Data Cloud 控制台 - 应用列表，获取您的 API Token，留作备用。
2. 如果你尚未登录或注册，会自动跳转到登录页面；登录注册之后会自动返回当前页面。
3. 首次申请时会有免费额度赠送，可以先免费体验 Seedance MCP 服务。

一个 Token 可以使用 AceData Cloud 提供的全部 11 个 MCP Server，无需为 Seedance 单独申请。文档和截图里建议只展示脱敏形式，例如 3b78cc40dd3b43db806a4300....，不要把完整 Token 贴到公开仓库、Issue、截图或聊天记录里。

想用 Claude Desktop / Claude.ai 网页版直接 OAuth 一键授权？请看 Seedance MCP 的 Claude.ai / Desktop 教程。

配置 OpenCode

OpenCode 用一份 opencode.json 描述所有 MCP Server，文件可以放在两处，按下面”作用范围”选一种即可。两种位置的字段结构完全相同，区别只是优先级。

强烈推荐先把 Token 写到环境变量里：

1

export ACEDATACLOUD_API_KEY="替换为你的真实 Token"

然后在 opencode.json 里用 {env:ACEDATACLOUD_API_KEY} 占位符引用，避免真实 Token 写进文件。

全局：所有项目共用

文件位置：~/.config/opencode/opencode.json，适合”我自己的机器，一次配好，所有项目都能用”。

1
2
3
4
5
6
7
8
9
10
11
12

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "seedance": {
      "type": "remote",
      "url": "https://seedance.mcp.acedata.cloud/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:ACEDATACLOUD_API_KEY}" }
    }
  }
}

⚠️ "oauth": false 不可省略。AceData 的 MCP Server 使用 Bearer Token 鉴权，不走 OAuth 流程；OpenCode 默认会把 401 当成 OAuth 挑战自动重定向，导致 opencode mcp list 出现 SSE error: Non-200 status code (401)。显式声明 "oauth": false 让 OpenCode 直接以 Authorization: Bearer ... 调用，opencode mcp debug seedance 也会回显 OAuth explicitly disabled，代表生效。

项目级：仅当前项目生效

文件位置：当前项目根目录下的 opencode.json，会覆盖全局配置。适合团队共享、单仓库定制，或者只在某个项目里临时启用某个 MCP。

1
2
3
4
5
6
7
8
9
10
11
12

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "seedance": {
      "type": "remote",
      "url": "https://seedance.mcp.acedata.cloud/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:ACEDATACLOUD_API_KEY}" }
    }
  }
}

如果项目级 opencode.json 会被提交到 Git，请确保用 {env:ACEDATACLOUD_API_KEY} 占位符而不是真实 Token，避免泄露。

💡 如果 Shell 里的 .env 没有显式 export，需要用 set -a && source .env && set +a 才能把变量传给 OpenCode 进程，否则 opencode debug config 会显示 "Authorization": "Bearer "（占位符没解析）。

真实运行结果

下面是在 OpenCode 1.15.13 里用隔离临时目录实际执行后的脱敏输出。命令使用真实 AceData Cloud Token，输出中的 Token 已替换成 357265014ad145fc8ab2....，临时配置已删除。

1
2
3
4
5
6
7
8
9
10
11

$ opencode --version
1.15.13

$ opencode mcp list

┌  MCP Servers
│
●  ✓ seedance connected
│      https://seedance.mcp.acedata.cloud/mcp
│
└  1 server(s)

看到 ✓ seedance connected 就说明 Seedance MCP 已经接入成功。如果显示 ✗ 或者 unauthorized，请检查 ACEDATACLOUD_API_KEY 是否设置、Token 是否复制完整、Authorization 前缀是否为 Bearer（注意大小写和空格）。

如需调试某一台 MCP 的连接细节：

1

opencode mcp debug seedance

实际握手成功后，OpenCode 的 INFO 日志会输出 service=mcp key=seedance transport=StreamableHTTP connected 和 service=mcp key=seedance toolCount=7 两行（实测 7 个工具），代表 Seedance MCP 已经准备好被模型调用。

🤖 选模型的实测建议：在 OpenCode 里要真正让模型主动调用 Seedance MCP，请优先使用 OpenAI 系列模型（如 acedatacloud/gpt-5-mini、acedatacloud/gpt-5）。AceData 上 Claude 系列模型通过 OpenAI 兼容接口暴露时，工具调用经常返回 Improperly formed request（实测：acedatacloud/claude-haiku-4-5-20251001、acedatacloud/claude-sonnet-4-6 在挂载多个 MCP 时均报这个错）。只做对话不调用工具时，Claude 模型可以正常使用。

典型场景

配置完成后，直接在 OpenCode 会话里用自然语言即可调用，无需先切到 /mcp：

文本生成短视频

1

生成一段竖屏短视频：少女在樱花树下转身，慢动作，唯美光影

图生视频

1

用这张图做封面，生成一段镜头慢慢推进的视频

生成视频片头

1

生成一段 3 秒的视频片头：一个发光的代码符号 </> 从模糊变清晰，背景有粒子特效，科技蓝色调

工具列表

下表列出主要工具（Seedance MCP Server 实测共暴露 7 个工具，可通过 curl -X POST https://seedance.mcp.acedata.cloud/mcp -H 'Authorization: Bearer <token>' -H 'Accept: application/json' -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' 获取完整清单）：

相关链接

• Seedance MCP Server（GitHub）
• Claude + Seedance MCP 图文教程（claude.ai / Desktop）
• OpenCode MCP Overview
• OpenCode 终端配置教程
• MCP 协议官网

BYOK（Bring Your Own Key）让你在 Nexior / Studio 的对话界面里，直接使用自己已有的上游服务商 API Key，完全绕开平台的账号池和积分计费。配置后该模型的对话请求会用你的 Key 直接打到 OpenAI / Anthropic / Google / xAI / DeepSeek / Moonshot / Zhipu —— 平台只做转发和工具拼装，不消耗任何积分。

适合场景：你已经有上游账号 + 余额，希望复用平台的 UI（云历史、Artifacts、引用、工具调用、Connector），但不想按平台的零售价付钱。

支持的提供商

每个 Provider 可保存多把 Key（例如个人 Key + 公司 Key），并通过 Label 区分。

5 分钟实操

第 1 步：打开 BYOK 设置

登录 studio.acedata.cloud → 右上角头像 → Settings → Custom API Key。

第 2 步：添加一把 OpenAI Key

1. 点 Add API Key；
2. Provider 选 OpenAI；
3. Label（可选）：My Work ID；
4. API Key：粘贴你的 sk-...；
5. Custom Base URL（可选）：留空走官方地址；如要走代理（例如 https://openai.acedata.cloud），把整段 base URL 填这里；
6. 勾选 Active 后保存。

第 3 步：开始对话

回到聊天，模型选 gpt-5.5 / gpt-5-pro / gpt-4.1 任一 OpenAI 模型，发一条消息。Studio 会优先匹配你已激活的 BYOK Key，并在对话顶部显示 BYOK · OpenAI 徽章 —— 看到这个徽章说明这条对话没消耗平台积分。

如果同一 Provider 有多把 Key，Studio 会按最近使用 + Label 优先选；你也能在徽章上点击切换。

注意事项

1. 只覆盖该 Provider 的模型：例如配置 OpenAI Key 只影响 GPT 系列，切到 Claude 仍会扣平台积分（除非你也配了 Anthropic Key）。
2. 工具调用、引用、Artifacts、Connector 不受影响：这些都是平台侧的能力，不论是否走 BYOK 都正常工作。
3. 错误处理透明：上游 401 / 429 / 5xx 会原样返回到对话，让你能直接看到上游 Key 的状态。
4. Key 加密保存：平台只在转发请求时解密；不写日志、不会出现在客户端。
5. 临时停用：把 Active 关掉而不删，下一条对话立即回退到平台积分计费。
6. 不支持流式生效切换：对话进行中不会改用 BYOK，新建对话或刷新页面后生效。

常见问题

Q：自定义 Base URL 怎么配？
A：场景 1（境内代理）：填 https://openai.acedata.cloud/v1，请求会先走 AceData Cloud 边缘再到 OpenAI；场景 2（私有网关）：填你公司内部的 OpenAI 兼容网关。注意末尾不要带斜杠、不要带 /chat/completions。

Q：能跟订阅 / 充值并存吗？
A：能。BYOK 优先于积分计费；当 BYOK Key 失效（401）时不会自动 fallback 到积分，会直接报错让你修 Key。

Q：能管理团队成员的 Key 吗？
A：当前 BYOK 是个人维度的。团队 / 站长可以在 Subsite 维度统一配置上游账号池，请参考 Subsite 教程。

相关链接

• Studio 在线体验
• Connector 教程
• Subsite 白标教程

Grok Tasks API 的主要功能是通过输入 Grok Videos Generation API 生成的任务 ID 来查询该任务的执行情况。

本文档将详细介绍 Grok Tasks API 的对接说明，帮助您轻松集成并查询 Grok Videos Generation API 的任务执行情况。

申请流程

要使用 Grok Videos Generation API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。

一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。

📘 完整文档：Grok Videos Generation API →

请求示例

Grok Tasks API 可以用于查询 Grok Videos Generation API 的结果。

设置请求头和请求体

Request Headers 包括：

• accept：指定接收 JSON 格式的响应结果，这里填写为 application/json。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

Request Body 包括：

• id：要查询的任务 ID。
• action：对任务的操作方式，单个查询填写 retrieve。

CURL 代码示例

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'

响应示例

请求成功后，API 将返回此处任务的详情信息。其中 request 字段是发起任务时的 request body，response 字段是任务完成后返回的 response body，例如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "request": {
    "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
    "model": "grok-imagine-video-1.5-fast",
    "resolution": "480p",
    "duration": 8
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "grok-imagine-video-1.5-fast:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
        "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
        "state": "succeeded"
      }
    ]
  }
}

字段介绍如下：

• id：生成任务的 ID，用于唯一标识此次生成任务。
• request：查询任务中的请求信息。
• response：查询任务中的返回信息。

批量查询操作

针对多个任务 ID 查询任务详情时，将 action 设置为 retrieve_batch，并通过 ids 传入任务 ID 数组：

Request Body 包括：

• ids：要查询的任务 ID 数组。
• action：对任务的操作方式，批量查询填写 retrieve_batch。

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'

Artistic QR Tasks API 的主要功能是通过输入 Artistic QR Generation API 生成的任务ID来查询该任务的执行情况。

本文档将详细介绍 Artistic QR Tasks API 的对接说明，帮助您轻松集成并充分利用该 API 的强大功能。通过 Artistic QR Tasks API ，您可以轻松实现查询 Artistic QR Generation API 的任务执行情况。

申请流程

要使用 Artistic QR Generation API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。

一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。

📘 完整文档：Artistic QR Generation API →

请求示例

Artistic QR Tasks API 可以用于查询 Artistic QR Generation API 一个 API 的结果。关于怎样使用 Artistic QR Generation API，请参考文档 Artistic QR Generation API 。

我们以 Artistic QR Generation API 服务返回的任务ID一个为例，演示如何使用该 API。假设我们有一个任务ID：e2c65b20-a970-431e-99c1-76721e799df8，接下来演示如何通过传入一个任务ID来。

任务示例图

设置请求头和请求体

Request Headers 包括：

• accept：指定接收 JSON 格式的响应结果，这里填写为 application/json。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

Request Body 包括：

• id：上传的任务ID。
• action：对任务的操作方式。

设置如下图所示：

代码示例

可以发现，在页面右侧已经自动生成了各种语言的代码，如图所示：

部分代码示例如下：

CURL

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/qrart/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "e2c65b20-a970-431e-99c1-76721e799df8",
  "action": "retrieve"
}'

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import requests

url = "https://api.acedata.cloud/qrart/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "e2c65b20-a970-431e-99c1-76721e799df8",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

响应示例

请求成功后，API 将返回此处二维码任务的详情信息。例如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

{
  "_id": "668cb62c550a4144a582e372",
  "id": "e2c65b20-a970-431e-99c1-76721e799df8",
  "application_id": "3d25be99-4676-44d3-90bb-23086bc25300",
  "created_at": 1720497708.318,
  "credential_id": "6e80fca1-9a49-4507-ae8e-601dbd0ab3ca",
  "request": {
    "aspect_ratio": "1:1",
    "callback_url": null,
    "content": "https://platform.acedata.cloud",
    "content_image_url": null,
    "ecl": "H",
    "image_origin": null,
    "marker_shape": "square",
    "negative_prompt": null,
    "padding_level": 5,
    "padding_noise": 0,
    "pattern": "custom",
    "pixel_style": "square",
    "position": "center",
    "preset": "",
    "prompt": "mexican tacos",
    "qrw": 2,
    "ratio": null,
    "rotate": 0,
    "seed": null,
    "steps": 20,
    "sub_marker": "square",
    "timeout": null,
    "trace_id": "a99ecc24-eda0-45c6-bb5f-98060c30b490",
    "type": "link"
  },
  "response": {
    "image_url": "https://platform.cdn.acedata.cloud/qrart/e2c65b20-a970-431e-99c1-76721e799df8.png",
    "image_width": 768,
    "image_height": 768,
    "seed": 5324369603686616,
    "success": true
  }
}

返回结果一共有多个字段，request 字段就是发起任务时的 request body，同时response 字段是任务完成后返回的response body，其结果和 Artistic QR Generation API 的请求和返回一致。字段介绍如下。

• id，生成此二维码任务的 ID，用于唯一标识此次二维码生成任务。
• request，查询二维码任务中的请求信息。
• response，查询二维码任务中的返回信息。

批量查询操作

这是是针对多个二维码任务ID来进行查询二维码任务详情，与上面不同的是需要将action选中为retrieve_batch

Request Body 包括：

• ids：上传的任务ID数组。
• action：对任务的操作方式。

设置如下图所示：

代码示例

可以发现，在页面右侧已经自动生成了各种语言的代码，如图所示：

部分代码示例如下：

CURL

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/qrart/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["8c89e97b-6a79-4406-b2ce-e00f92540b4e","e2c65b20-a970-431e-99c1-76721e799df8"],
  "action": "retrieve_batch"
}'

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import requests

url = "https://api.acedata.cloud/qrart/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["8c89e97b-6a79-4406-b2ce-e00f92540b4e","e2c65b20-a970-431e-99c1-76721e799df8"],
    "action": "retrieve_batch"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

响应示例

请求成功后，API 将返回此次所有批量二维码任务的具体详情信息。例如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

{
  "items": [
    {
      "_id": "668cb90e550a4144a5834557",
      "id": "8c89e97b-6a79-4406-b2ce-e00f92540b4e",
      "application_id": "3d25be99-4676-44d3-90bb-23086bc25300",
      "created_at": 1720498446.039,
      "credential_id": "b7f9aaa1-43d8-471f-a826-cd0f4733fec5",
      "request": {
        "aspect_ratio": "1:1",
        "callback_url": null,
        "content": "https://huyinfu.space",
        "content_image_url": null,
        "ecl": "H",
        "image_origin": null,
        "marker_shape": "square",
        "negative_prompt": null,
        "padding_level": 5,
        "padding_noise": 0,
        "pattern": "custom",
        "pixel_style": "square",
        "position": "center",
        "preset": "",
        "prompt": "mexican tacos",
        "qrw": 2,
        "ratio": null,
        "rotate": 0,
        "seed": null,
        "steps": 20,
        "sub_marker": "square",
        "timeout": null,
        "trace_id": "44d33486-0527-451f-afc2-df11aab7e049",
        "type": "link"
      },
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/qrart/8c89e97b-6a79-4406-b2ce-e00f92540b4e.png",
        "image_width": 768,
        "image_height": 768,
        "seed": 2701847236953402,
        "success": true
      }
    },
    {
      "_id": "668cb62c550a4144a582e372",
      "id": "e2c65b20-a970-431e-99c1-76721e799df8",
      "application_id": "3d25be99-4676-44d3-90bb-23086bc25300",
      "created_at": 1720497708.318,
      "credential_id": "6e80fca1-9a49-4507-ae8e-601dbd0ab3ca",
      "request": {
        "aspect_ratio": "1:1",
        "callback_url": null,
        "content": "https://platform.acedata.cloud",
        "content_image_url": null,
        "ecl": "H",
        "image_origin": null,
        "marker_shape": "square",
        "negative_prompt": null,
        "padding_level": 5,
        "padding_noise": 0,
        "pattern": "custom",
        "pixel_style": "square",
        "position": "center",
        "preset": "",
        "prompt": "mexican tacos",
        "qrw": 2,
        "ratio": null,
        "rotate": 0,
        "seed": null,
        "steps": 20,
        "sub_marker": "square",
        "timeout": null,
        "trace_id": "a99ecc24-eda0-45c6-bb5f-98060c30b490",
        "type": "link"
      },
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/qrart/e2c65b20-a970-431e-99c1-76721e799df8.png",
        "image_width": 768,
        "image_height": 768,
        "seed": 5324369603686616,
        "success": true
      }
    }
  ],
  "count": 2
}

返回结果一共有多个字段，其中items是包含了批量二维码任务的具体详情信息，每个二维码任务的具体信息与上文的字段一样，字段信息如下。

• items，批量二维码任务的所有具体详情信息。它是一个数组，每个数组的元素和上文查询单个任务的返回结果格式是一样的。
• count，此处批量查询二维码任务的个数。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

1
2
3
4
5
6
7
8

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 Artistic QR Tasks API 进行查询单个或批量二维码任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

Claude Code 原生通过 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量决定请求发往哪里，把它们指向 Ace Data Cloud 即可用更低的价格、无需 Anthropic 官方订阅来使用 Claude Code。手动编辑 .claude/settings.json 对新手并不友好，而 CC Switch 提供了一个图形界面，帮你把这两个变量一键写好、并在多套供应商之间即时切换。

本文介绍如何用 CC Switch 把 Claude Code 接入 Ace Data Cloud。

什么是 CC Switch

CC Switch（官网 ccswitch.io）是一个开源、跨平台的桌面端配置管理器，用于统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等多个 AI 编程工具的供应商配置。它基于 Tauri 2 构建，采用 MIT 协议开源，在 GitHub 上已获得超过 11 万 Star（参见 farion1231/cc-switch）。

它的核心价值在于（详见官方 User Manual）：

• 免手动改配置：不用再手写 settings.json / config.toml / .env，图形界面填一次即可。
• 一键切换：预存多套供应商，从主界面或系统托盘即时切换。
• 原子写入：所有数据存于本地 SQLite 数据库（~/.cc-switch/cc-switch.db），采用「临时文件 + 重命名」的原子写入，避免配置损坏。

CC Switch 的工作原理是在底层动态覆盖 Claude Code 的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，把原本发往 Anthropic 官方的请求重定向到你配置的第三方接口（本例即 Ace Data Cloud）。这一机制在社区的图文教程中也有详细说明。

CC Switch 官方主界面与「添加供应商」面板如下（截图来自 CC Switch 官方仓库）：

申请 API Token

要使用 Claude Code，首先到 Ace Data Cloud 控制台，获取你的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，登录注册之后会自动返回当前页面。首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

提示：也可以前往 Claude Messages 服务页面 点击「Acquire」获取凭证，即赠免费额度；额度不足时可在 控制台 - 通用余额 充值。

下载与安装 CC Switch

前往 CC Switch 的 Releases 页面（或直接下载最新版本），按操作系统选择对应安装包。以下安装方式均来自官方 README：

安装完成后启动 CC Switch，准备添加供应商。

首次启动时，CC Switch 可以把你已有的 CLI 配置导入为默认供应商（参见官方 Quick Start），避免覆盖原有配置。

添加 Ace Data Cloud 供应商

CC Switch 内置了 50+ 供应商预设，但目前不含 Ace Data Cloud，因此我们使用「Custom（自定义）」方式添加。以下步骤对应官方文档 2.1 Add Provider。

1. 在 CC Switch 顶部切换到 Claude Code 应用。
2. 点击右上角的 +（Add Provider）按钮打开添加面板，在 App-specific Provider 标签下操作。
3. 在预设下拉框中选择 Custom，然后填写配置。

CC Switch 官方「添加供应商」面板如下（截图来自 CC Switch 官方仓库）：

按如下信息填写：

选择 Custom 后，也可以直接在 JSON 编辑框中填入 Claude 配置。Ace Data Cloud 提供原生兼容 Anthropic Messages API 的代理，因此使用默认的 ANTHROPIC_* 环境变量即可（配置格式参见官方 Claude Configuration Format）：

1
2
3
4
5
6

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

其中 {token} 替换为你在 Ace Data Cloud 控制台复制的 API Token。核对无误后点击 Add 完成添加。

API 格式（Advanced Options）：Ace Data Cloud 使用原生 Anthropic Messages 协议，因此高级选项中的 API Format 保持默认的 Anthropic Messages 即可，无需开启本地路由或格式转换。

启用并切换供应商

添加完成后，在 Claude Code 供应商列表中找到 Ace Data Cloud 卡片，点击 Enable（启用） 即可（参见官方 2.2 Switch Provider）。你也可以从系统托盘菜单直接点击供应商名称进行即时切换，无需打开完整界面。

是否需要重启？ 根据官方 FAQ，Claude Code 支持「热切换」——切换供应商后无需重启即可生效；其余大多数工具（如 Codex、Gemini CLI）则需要重启对应 CLI 或终端。

CC Switch 启用供应商时，会把上面的配置写入 Claude Code 的配置文件（用户级 ~/.claude/settings.json）。因此，无论你在终端里运行 claude，还是使用 VS Code 的 Claude Code 扩展，都会读取到同一份配置。配置文件的位置与格式参见官方 5.1 配置文件说明。

在终端与 VS Code 中使用

CC Switch 只负责写入配置，Claude Code 本体仍需单独安装。启用供应商后：

• 终端 CLI：安装并运行 claude 即可，完整步骤见 Claude Code 终端配置教程。进入交互界面后输入 /status，应能看到 Anthropic base URL: https://api.acedata.cloud。

  

• VS Code 扩展：在扩展市场安装 Claude Code 扩展，完整步骤见 Claude Code VS Code 配置教程。由于扩展和 CLI 共享同一份配置，CC Switch 写好后 VS Code 扩展会直接复用，无需再手动填写。

• GitHub Actions：如果你想在 CI/CD 中使用，参见 Claude Code GitHub Actions 配置教程（该场景通过 Secrets 注入变量，通常不使用 CC Switch）。

远程开发（Remote - SSH）

如果你通过 VS Code Remote - SSH 在远程服务器上开发，远程端读不到你本机的环境变量。此时可以借助 CC Switch 的本地代理（Local Proxy）功能：在 CC Switch 中开启本地代理后，它会在本机监听一个端口并转发请求；再通过 SSH 的 RemoteForward 把该端口转发到远程主机，远程的 Claude Code 即可复用本地供应商。本地代理的配置说明见官方 4.1 Proxy Service，Remote - SSH 的完整图文步骤可参考社区教程 Golden-Promise/vscode-cc-switch。

查看额度与用量

• 通过 Ace Data Cloud 控制台 - 应用列表 查看当前账户的剩余额度。
• 通过 Ace Data Cloud 控制台 - 使用历史 查看所有请求记录与扣费详情。

常见问题

• 为什么无法删除当前正在使用的供应商？ CC Switch 遵循「最小侵入」原则，始终保留一个已启用配置，避免删除全部配置后 CLI 工具无法使用。详见官方 FAQ。
• 如何切回官方登录？ 从预设列表添加一个官方登录（Official Login）供应商，切换后按照官方登录 / OAuth 流程操作即可（参见官方 Quick Start）。
• 配置数据存在哪里？ 供应商、MCP、Prompts、Skills 等数据存于 ~/.cc-switch/cc-switch.db（SQLite），设备级 UI 偏好存于 ~/.cc-switch/settings.json，自动备份位于 ~/.cc-switch/backups/（参见官方 FAQ）。

参考来源

• CC Switch 项目仓库：https://github.com/farion1231/cc-switch
• CC Switch 官网：https://ccswitch.io/
• CC Switch 用户手册：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/README.md
• 添加供应商（2.1 Add Provider）：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/2-providers/2.1-add.md
• 切换供应商（2.2 Switch Provider）：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/2-providers/2.2-switch.md
• 本地代理（4.1 Proxy Service）：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/4-proxy/4.1-service.md
• 社区图文教程（VS Code + cc-Switch）：https://github.com/Golden-Promise/vscode-cc-switch
• Claude Code 官方 VS Code 文档：https://code.claude.com/docs/en/vs-code
• Ace Data Cloud Claude Messages 服务：https://platform.acedata.cloud/documents/claude-messages

📘 Overview：Claude Desktop MCP Overview →

Fish Audio 是高保真 TTS 引擎，支持自定义音色、多种采样率和格式（mp3 / wav / opus）。模型可选 s1 / s2-pro，延迟可控。

配置 Claude Desktop

claude.ai 网页版和 Claude Desktop 都支持远程 MCP Connector：

1. 打开 https://claude.ai/customize/connectors（或 Claude Desktop 的 Settings → Connectors）。

2. 点击 Add custom connector，Name 填 fish 或 Fish，URL 填：

   1	https://fish.mcp.acedata.cloud/mcp

3. 首次连接会跳转到 AceData Cloud 完成 OAuth 授权，确认后即可在对话中调用。

Fish 语音 能做什么？

Fish Audio 是高保真 TTS 引擎，支持自定义音色、多种采样率和格式（mp3 / wav / opus）。模型可选 s1 / s2-pro，延迟可控。

把它接到 Claude.ai 或 Claude Desktop，下面这些场景都能直接在对话里完成：

• 用 fish_generate_audio 把这段中文合成成 mp3，用默认音色

• 把这段英文合成成 wav，采样率 44100，使用音色 ID xxxx

• 把这段播客脚本合成成 mp3，bitrate 128，低延迟模式

注意事项

• 远程 MCP 计费在 AceData Cloud 端按调用扣费，首次注册会送免费额度。
• OAuth 授权后，Connector 会绑定到你授权时使用的 AceData Cloud 账号。
• 一个 AceData Cloud 账号可以授权所有 MCP Connector，无需为 Fish 语音 单独申请额度。

工具

相关链接

• Fish Audio MCP Server（GitHub）
• Fish Audio MCP on PyPI
• Claude Desktop MCP Overview
• MCP 协议官网

查询由 POST /maestro/videos 创建的视频任务的状态与结果。轮询免费,不消耗积分。

POST https://api.acedata.cloud/maestro/tasks

查询单个任务

1
2
3
4

curl -X POST https://api.acedata.cloud/maestro/tasks \
  -H "authorization: Bearer {token}" \
  -H "content-type: application/json" \
  -d '{ "id": "f57e99c4f60f4373a15517742ce2357d", "action": "retrieve" }'

返回(每种语言对应一个 variant):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

{
  "id": "f57e99c4f60f4373a15517742ce2357d",
  "status": "succeeded",
  "elapsed": 312,
  "request": { "prompt": "…", "langs": ["zh-cn", "en"], "aspect": "9:16", "duration": 20 },
  "response": {
    "success": true,
    "data": {
      "variants": [
        { "lang": "zh-cn", "aspect": "9:16", "kind": "video", "title": "什么是向量数据库", "output_url": "https://…/zh.mp4" },
        { "lang": "en", "aspect": "9:16", "kind": "video", "title": "What is a vector database", "output_url": "https://…/en.mp4" }
      ],
      "project": { "tarball_url": "https://…/project.tar.gz", "outputs": ["https://…/zh.mp4", "https://…/en.mp4"] },
      "progress": [ { "stage": "producing", "message": "rendering scene 2", "pct": 60, "t": 1750000000 } ],
      "stage": "succeeded"
    }
  }
}

status 取值:pending → planning → producing → succeeded(或 failed)。response.data.progress 是按阶段追加的进度数组,可用于展示实时进度条。建议每 5–10 秒轮询一次,直到 succeeded 或 failed。

查询历史列表

传 action: retrieve_batch 取当前用户最近的任务(按创建时间倒序),可用于「我的视频」列表:

1
2
3
4

curl -X POST https://api.acedata.cloud/maestro/tasks \
  -H "authorization: Bearer {token}" \
  -H "content-type: application/json" \
  -d '{ "action": "retrieve_batch", "limit": 20 }'

返回:

1

{ "count": 2, "items": [ { "id": "…", "status": "succeeded", "request": { … }, "response": { … } } ] }

📘 完整指南：在 Codex CLI 里用全部 11 个 AceData Cloud MCP →

字节跳动出品的视频模型，舞蹈、运动、连贯动作表现优异，支持竖屏 9:16 短视频。通过 MCP 接入 Codex CLI 后，可以直接在对话里调用，不用切窗口、不用复制粘贴。

获取 API Token

到 AceData Cloud 平台 注册账号，复制首页的 API Token——一个 Token 即可使用全部 11 个 MCP Server。详细步骤见 完整指南。

配置

编辑配置：~/.codex/config.toml

1
2
3
4
5

[mcp_servers.seedance]
url = "https://seedance.mcp.acedata.cloud/mcp"
type = "http"

http_headers = { "Authorization" = "Bearer 你的Token" }

保存后下一次 codex 会话启动时自动加载工具。

使用示例

用 Seedance 生成一段竖屏短视频：一个女孩在樱花树下转圈跳舞，9:16

把这张图（链接 xxx）做成一段 5 秒动作视频

生成一段 10 秒 1080P 美食制作视频：寿司师傅切金枪鱼，特写镜头

工具

相关链接

• Seedance MCP Server (GitHub)
• Seedance MCP on PyPI
• AceData Cloud 平台
• MCP 协议官网

这篇文档说明用 X402 调用 Ace Data Cloud API 时，价格是怎么定的，以及它和平台普通 Credits（额度）价格是什么关系。

核心结论

X402 不是一套独立的价格体系。每个 API 调用本来就有一个以 Credits 计的成本，这是所有计费方式（API Token 扣额度、账户余额、X402 链上支付）共用的唯一价格来源。X402 只是把这个 Credits 成本按一个固定汇率换算成链上 USDC：

1 Credit = 0.095215 USDC（即 95215 atomic USDC，USDC 为 6 位小数）

也就是说：

1

X402 价格 (USDC) = 该次调用的 Credits 成本 × 0.095215

这个汇率不是凭空设定的，它等于平台 最优档（大额）Credits 单价。所以用 X402 付费 ≈ 用最优档单价买 Credits 再消费，没有 X402 溢价，反而直接享受最便宜的 Credits 单价，且无需预充值、无需 API Token。

计价基准

换算由平台统一完成，金额对所有支持的网络（Base、SKALE、Solana）一致；不同网络只是资产合约和签名方式不同，价格相同。

和普通 Credits 单价的关系

平台 Credits 按「用量越大、单价越低」的阶梯出售。X402 按调用计费时，统一使用阶梯最优档单价：

换句话说，X402 把每次调用都按最优档 Credits 单价结算。小额充值买 Credits 的用户，单价会高于 X402；大额充值用户的单价才和 X402 一致。

两种价格形态：exact 与 upto

X402 的 402 响应里，maxAmountRequired 就是你要签名的金额。它有两种形态：

• exact（固定价）：请求处理前价格就能确定（图片、视频、音乐、搜索、订单支付）。maxAmountRequired = 该调用 Credits 成本 × 0.095215，即该次调用的应付金额（与成功响应里的 cost.amount 一致）。
• upto（用量后置计量）：聊天补全这类「响应结束才知道用了多少 token」的接口。maxAmountRequired 是一个上限（按该模型设定的上限额度换算：上限 Credits × 0.095215），实际按真实用量结算，且不超过上限。

关于这两种 scheme 的协议细节见 exact 与 upto 计费方案。下面只讲价格。

Chat（聊天补全）价格

聊天补全是 upto 计量：按 prompt / completion token 实际用量计费。每百万（1M）token 的价格 = 该模型每 1M token 的 Credits 成本 × 0.095215，与平台公开模型目录（/api/v1/models?with_pricing=true）展示的 USD 单价完全一致。

下表为真实价格（取自模型目录，按 X402 汇率计），单位 USD / 1M token：

说明：

• 表中为按 token 计量的单价；一次请求费用 = 输入 token × 输入单价 + 输出 token × 输出单价。
• upto 上限是该模型一次请求允许签名的最大金额；它不是实际扣款，绝大多数请求远低于上限。
• 上限只决定「最多可能扣多少」，真实结算按 token 用量计算。

示例：报价与扣费一致（exact）

下面是用官方 X402Client 对 serp/google 发起的一次真实付费调用（Base exact）。它演示了三者一致：402 报价、签名金额、以及成功响应里返回的 cost。

1
2
3
4
5
6
7
8

# 1) 未支付请求 -> 402，拿到报价（不扣费）
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215，向下取整到 atomic = 952

# 2) 用钱包签名 952 atomic 的 X-Payment，重试
POST /serp/google (X-Payment) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}

响应返回的 cost.amount（0.000952 USDC）与 402 报价、与 Credits × 0.095215 完全一致。settlement 字段是该笔支付的结算状态（authorized = 已授权）；链上结算由平台处理，机制见 exact 与 upto 计费方案。

upto 报价计算（聊天）

聊天按 token 计量。某次请求的报价（不是上限）按下式计算（以 gpt-4o-mini 为例）：

1
2

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

一次 500 prompt + 200 completion token 的请求：

1
2

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
报价 USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

客户端按 upto 上限（gpt-4o-mini 为 1 Credit = 95215 atomic）签名，这只是最多可能扣多少；该次请求的真实报价（上例约 $0.0001）远低于上限，按 token 用量结算。upto 的链上结算机制见 exact 与 upto 计费方案。

其他服务价格（固定价 exact）

图片、视频、音乐、搜索这类接口在请求时价格即可确定，使用 exact。下表为真实价格，取自线上接口对未支付请求返回的 402 maxAmountRequired（查询报价不会产生扣费）：

说明：

• 同一服务的价格随模型、分辨率、时长、动作变化（尤其是视频）。上表是某一组参数下的真实取值，仅供量级参考。
• 这类固定价（exact）接口，该请求 402 响应里的 maxAmountRequired 即该次应付金额（与成功响应的 cost.amount 一致，上节已实测）。
• 每个价格都由 Credits × 0.095215 向下取整到 atomic 单位得到（见上文计价基准），与聊天用的是同一套换算。因浮点表示与取整，个别值可能与朴素乘积相差 1 atomic（$0.000001），一律以 402 返回值为准。

订单支付价格

用 X402 支付控制台订单（购买套餐 / 充值 Credits）时，价格以订单页面显示为准，402 的 maxAmountRequired 为最终签名依据。订单支付走平台 API、需要账户令牌，详见 订单支付教程。

订单支付教程中的一个真实例子（购买 10 Credits）：

1
2
3
4

description Ace Data Cloud Credits x 10.0
created price 1.26          # 订单创建价（USD）
settled    1.20 USDC        # 最终签名/结算金额（= 402 maxAmountRequired）
            = 1200000 atomic USDC

注意：按调用付费（上文 Chat / 其他服务）和订单支付是两条不同路径。按调用付费统一用 0.095215/Credit 的最优档单价；订单支付按套餐定价，其创建价与最终结算金额的差异以 订单支付教程 为准。

如何实时获取价格

价格随模型和参数变化，请用程序实时获取，不要硬编码：

• 按调用价格：对目标 API 发一次不带 X-Payment（也不带 Authorization）的请求，读取返回的 402 accepts[].maxAmountRequired。这一步不会扣费。对 exact 接口它是最终价格；对 upto 接口（聊天）它是上限，实际按用量结算。
• 聊天每 token 单价：GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat，读取每个模型的 pricing.input_usd / pricing.output_usd（已按 credit_usd_rate 计算）。
• 换算校验：atomic = floor(Credits × 0.095215 × 1e6)，USDC = atomic / 1e6（即 USDC ≈ Credits × 0.095215）。

获取价格的最小请求示例：

1
2
3
4

curl -sS -X POST https://api.acedata.cloud/midjourney/imagine \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "a cat"}'
# 返回 402，accepts[].maxAmountRequired 即为该次（exact）调用价格

小结

• X402 价格 = 该次调用的 Credits 成本 × 0.095215，和普通 Credits 计费是同一个价格，只是用链上 USDC 结算。
• 0.095215/Credit 是平台最优档（大额）Credits 单价；小额充值买 Credits 单价更高，所以 X402 等于自动拿到最优单价。
• exact 接口（图片 / 视频 / 音乐 / 搜索 / 订单）签名金额即该次应付金额；upto 接口（聊天）签名的是上限，按真实用量结算。
• 权威价格以 402 返回的 maxAmountRequired 为准：exact 是应付金额（与成功响应的 cost.amount 一致，已实测）；upto 是上限，成功响应的 cost.amount 才是按用量结算的真实金额（≤ 上限）。

相关文档

本教程用一个最小的 API 请求说明 Ace Data Cloud X402 的完整流程。目标不是先写复杂代码，而是先看懂：为什么第一次请求会返回 402、accepts 里有什么、X-Payment 又是怎样让同一个 API 请求变成已支付请求的。

准备工作

你需要准备：

X402 调用 Ace Data Cloud API 时不需要 API Token。SDK 第一次请求不带 Authorization，Gateway 会返回 402 Payment Required 和支付要求；SDK 签名后自动重试。

安装 SDK

源码和包地址：

• SDK 仓库：https://github.com/AceDataCloud/SDK
• X402 Client 仓库：https://github.com/AceDataCloud/X402Client
• npm：@acedatacloud/sdk、@acedatacloud/x402-client
• PyPI：acedatacloud、acedatacloud-x402

TypeScript：

1

npm install @acedatacloud/sdk @acedatacloud/x402-client ethers

Python：

1

pip install acedatacloud acedatacloud-x402

如果要使用 Solana，还需要安装对应依赖：

1

npm install @solana/web3.js

Python 版本的 Solana signer 依赖已经包含在 acedatacloud-x402 中。

干净临时环境的安装和导入检查输出：

1
2
3
4
5
6
7
8
9

@acedatacloud/sdk@2026.504.2
@acedatacloud/x402-client@2026.531.3
ethers@6.16.0
@solana/web3.js@1.98.4

acedatacloud 2026.4.26.1
acedatacloud-x402 2026.5.31.3
imports_ok True True True True True True
usage: acedatacloud-x402 [-h] {approve-permit2} ...

结果说明：

• npm 包和 PyPI 包都是真实发布包，不是文档里的占位名称。
• acedatacloud-x402[cli] 会安装 CLI，approve-permit2 子命令可用于 upto 场景的 Permit2 授权。

第一次请求会返回 402

你可以先用 curl 看看未支付请求返回什么。下面示例不会产生扣费，因为它没有携带 X-Payment：

1
2
3
4
5
6
7

curl -sS -X POST https://api.acedata.cloud/openai/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "hi"}],
    "max_tokens": 1
  }'

返回体会包含 accepts 数组，常见结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "95215",
      "maxTimeoutSeconds": 3600,
      "resource": "/openai/chat/completions",
      "description": "...",
      "payTo": "0x...",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2",
        "chainId": 8453,
        "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }
    }
  ]
}

生产 API 未支付请求的程序输出摘要如下：

1
2
3
4
5
6
7
8
9

status=402
x402Version 2
accepts [
  ('base', 'exact', '95215'),
  ('base', 'upto', '95215'),
  ('solana', 'exact', '95215'),
  ('skale', 'exact', '95215'),
  ('skale', 'upto', '95215')
]

结果说明：

• 第一次请求没有携带 Authorization 或 X-Payment，所以返回 HTTP 402，不会产生扣费。
• accepts 是本次请求唯一可信的签名依据，包含可选网络、scheme、金额上限、收款地址和资产地址。
• 这次 gpt-4o-mini 最小聊天请求的上限金额是 95215 atomic USDC，也就是 0.095215 USDC。
• 每次请求都应该读取当次 402 响应，不要把示例金额硬编码进业务代码。

字段含义：

用 SDK 完成支付重试

下面是最小 TypeScript 示例。它指定 network: 'skale'，handler 会从本次 402 响应中选择 SKALE 的 payment requirement；实际金额和收款地址仍以 accepts 为准：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

import { Wallet } from 'ethers';
import { AceDataCloud } from '@acedatacloud/sdk';
import { createX402PaymentHandler } from '@acedatacloud/x402-client';

const wallet = new Wallet(process.env.SKALE_PRIVATE_KEY!);

const evmProvider = {
  async request({ method, params }: { method: string; params?: unknown[] }) {
    if (method !== 'eth_signTypedData_v4') {
      throw new Error(`unsupported method: ${method}`);
    }
    const [, typedDataJson] = params as [string, string];
    const typedData = JSON.parse(typedDataJson);
    return wallet.signTypedData(typedData.domain, typedData.types, typedData.message);
  }
};

const client = new AceDataCloud({
  paymentHandler: createX402PaymentHandler({
    network: 'skale',
    evmProvider,
    evmAddress: wallet.address
  })
});

const response = await client.openai.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Reply with exactly: hello' }],
  max_tokens: 8
});

console.log(response.choices[0].message.content);

同一链路用 TypeScript SDK 的程序运行结果：

1
2
3
4

payer 0xd0479FA9FD8C678303d477433d24C15e3723CC1C
elapsed_ms 6782
content ADC_TS_SDK_X402_OK
id chatcmpl-DlcVLO4PQWvmjPDQpy9yQw2QdLGAT

结果说明：

• content ADC_TS_SDK_X402_OK 是上游模型按提示词返回的固定字符串，说明付费重试后请求真实进入了模型 API。
• payer 是本地签名钱包地址，私钥没有发送给 Ace Data Cloud。
• SDK 完成了 402 解析、X-Payment 签名和原请求重试；业务代码仍按普通 SDK 调用方式写。

这段代码背后发生了四步：

1. SDK 发送一次普通 API 请求，不带 Authorization。
2. Gateway 返回 402 Payment Required 和 accepts。
3. createX402PaymentHandler 选择 network = 'skale' 的 payment requirement 并签出 X-Payment。
4. SDK 用同一个请求体重试，Gateway 调用 Facilitator 验证并结算后放行到上游 API。

查看公开发现文档

Ace Data Cloud 提供 X402 discovery 文档：

1

curl https://platform.acedata.cloud/.well-known/x402

返回结构为：

1
2
3
4
5
6

{
  "version": 1,
  "resources": [
    "https://api.acedata.cloud/openai/chat/completions"
  ]
}

Discovery 接口程序输出：

1
2
3

discovery_version 1
resources_count 70
has_chat True

结果说明：

• has_chat True 表示 discovery 文档中包含 OpenAI-compatible chat 资源。
• discovery 文档用于发现资源；实际支付金额仍以 API 请求返回的 402 accepts 为准。

注意 discovery 文档位于 platform.acedata.cloud，而实际 API 请求位于 api.acedata.cloud。

查看 Facilitator 支持能力

Ace Data Cloud 的生产 Facilitator 地址为：

1

https://facilitator.acedata.cloud

可以查看它支持哪些网络和 scheme：

1

curl https://facilitator.acedata.cloud/supported

返回的 kinds 会列出 Facilitator 支持的能力，例如 base/exact、base/upto、skale/exact、skale/upto、solana/exact，以及测试网络能力。实际调用时仍以 API 返回的 accepts 为准。

Facilitator /supported 程序输出：

1
2
3
4
5

kinds ['base/exact', 'base/upto', 'skale/exact', 'skale/upto', 'solana/exact', 'solana-devnet/exact']
upto_extra [
  ('base', {'facilitatorAddress': '0xd019...5708'}),
  ('skale', {'facilitatorAddress': '0xd047...CC1C'})
]

结果说明：

• /supported 说明 Facilitator 具备这些网络和 scheme 的验证、结算能力。
• 具体 API 是否允许某个网络，仍以该 API 的 402 accepts 为准。

📘 总览指南：在 Claude 里用全部 11 个 AceData Cloud MCP →

长链丢给微信、Twitter、海报、PPT，永远是个麻烦事——又丑又截断。挂上 AceData Cloud 的 ShortURL MCP，Claude 在聊天框里一句话就能给你回一个 surl.id/xxx 的短链，复制即用。

本文是一篇亲手在 Claude.ai 网页版跑通的实测记录：从添加 Connector、OAuth 授权，到一句 prompt 把一条长 URL 缩成 https://surl.id/1uNbTadEob，全程截图，复制即可复现。

什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 推出的开放协议，让 Claude 这类模型可以通过标准接口调用外部工具。简单理解：给 Claude 装上插件能力。

AceData Cloud 把 ShortURL 的核心能力封装成了一个远程 MCP Server，挂上去之后 Claude 就能直接：

• 单个短链生成（shorturl_create）
• 批量短链生成（shorturl_batch_create）
• 查询 API 信息 / 配额（shorturl_get_api_info）
• 查阅使用指南（shorturl_get_usage_guide）

整套接入只需一个 URL，剩下交给 Claude。

在 Claude.ai 网页版添加 ShortURL MCP

💡 Claude.ai 网页版接入是 OAuth 直连，不需要复制 API Token。你只需要一个能登录 AceData Cloud 的账号（GitHub / Google / 微信均可）。

1. 打开 Connectors 设置

登录 https://claude.ai，点左下角头像 → Settings → Customize → Connectors，或直接访问 https://claude.ai/customize/connectors。

⚠️ 旧入口 /settings/connectors 已经迁移到 /customize/connectors，访问旧地址会看到一条 “Connectors have moved to Customize” 的提示。

2. 添加 ShortURL MCP Server

点击右上角加号 → Add custom connector，在弹出对话框里填：

点 Add，Claude 会自动发现 Server 暴露的全部工具。

3. OAuth 授权

点 Connect → 跳转到 AceData Cloud OAuth 授权页 → 用账号登录、点 Allow 即可。如果还没注册，先去 https://platform.acedata.cloud 注册一下，注册即送免费额度，足够你跑完本文的 demo。

4. 检查工具列表 & 把工具切到 Always allow

授权完成后回到 Claude.ai，点开 ShortURL Connector，能看到 4 个工具：shorturl_create、shorturl_batch_create、shorturl_get_api_info、shorturl_get_usage_guide。

⚙️ 强烈建议把右上角的 Needs approval 下拉切换到 Always allow，否则每次工具调用都会弹确认框。一次缩短只触发 1 次工具调用，但用多了还是建议直接 Always allow。

实测：一句英文 Prompt 缩短长链

下面是我真实跑出来的对话：

Prompt: Use ShortURL to shorten this URL: https://platform.acedata.cloud/documents/claude-desktop-mcp-all — return both the short URL and the QR code info if available.

Claude 收到后做的事情：

1. 自动调用 shorturl_create，把原 URL 提交给 ShortURL API
2. 几秒钟拿到结果：https://surl.id/1uNbTadEob
3. 在聊天框里贴出短链，并诚实地补充：”API 这次没返回 QR code 字段，如果你需要二维码我可以另外帮你生成”

下面是聊天最终结果截图：

💡 surl.id 是 AceData Cloud 自营的短链域名：永久有效、不被国内主流社交平台屏蔽、支持点击统计（在 https://platform.acedata.cloud 控制台查看）。

更多玩法（同样一个 Connector）

把 prompt 换成下面这些，Claude 会自动选合适的工具：

批量缩链

1

Use ShortURL batch_create to shorten these 3 URLs in one call: https://platform.acedata.cloud, https://claude.ai, https://modelcontextprotocol.io.

→ Claude 调 shorturl_batch_create，一次性返回 3 条短链。

查 API 信息 / 余额

1

Use ShortURL to check my API info / remaining quota.

→ Claude 调 shorturl_get_api_info，告诉你额度还剩多少。

一站式：缩链 + 生成营销文案

1

Shorten https://my-product.com/launch with ShortURL, then write me a 100-character Twitter announcement that uses the short link.

→ Claude 先调 shorturl_create，拿到短链后直接写文案。

配合其他 MCP 做工作流

1

Generate a Midjourney poster of "AI agent revolution", upload, then use ShortURL to shorten the image URL for me.

→ Claude 先用 Midjourney MCP 出图，再用 ShortURL 把图片 URL 缩短。

常见问题

Q：为什么我点了 Always allow，新工具还是要确认？
A：Always allow 是按工具粒度记忆的。create、batch_create、get_api_info、get_usage_guide 是 4 个不同工具，第一次各确认一次即可。

Q：余额不够怎么办？
A：错误信息里会带 insufficient balance。去 https://platform.acedata.cloud/console/coin 充值，支持支付宝 / 微信 / Stripe / USDC。短链单次消耗极低，新账号免费额度够你缩几百次。

Q：和 bit.ly / t.cn 比有什么优势？
A：surl.id 是 AceData Cloud 自营域名，不会突然被墙、不会强插广告页；配合 MCP 让 Claude 自动批量缩链，比手动一条条粘 bit.ly 强太多；可以和其他 MCP 串成工作流（出图 → 上传 → 缩链 → 发文）。

Q：Claude Desktop 和 Claude Code 也能这么用吗？
A：能。详见 Claude Desktop + ShortURL MCP 和 Claude Code + ShortURL MCP。

相关链接

• ShortURL MCP Server URL
• ShortURL MCP GitHub
• ShortURL MCP PyPI
• AceData Cloud 平台
• MCP 协议官网

📘 Overview：Claude Code MCP Overview →

Fish Audio 是高保真 TTS 引擎，支持自定义音色、多种采样率和格式（mp3 / wav / opus）。模型可选 s1 / s2-pro，延迟可控。

获取 API Token

使用 Fish 语音 MCP Server 之前，需要先准备一个 AceData Cloud API Token：

1. 打开 Ace Data Cloud 控制台 - 应用列表 复制 Token。
2. 如果还没有账号，登录注册时会自动跳回当前页面，首次申请会赠送免费额度。

一个 Token 可以使用 AceData Cloud 提供的全部 MCP Server，无需为 Fish 语音 单独申请。

用 claude.ai 网页版或 Claude Desktop？它们支持 OAuth 一键授权，无需手动填 Token，详见 Fish 语音 MCP 的 Claude.ai / Desktop 教程。

配置 Claude Code

1
2
3

claude mcp add fish --transport http https://fish.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 你的Token" \
  -s user

也可以用 -s local（仅当前项目）或 -s project（项目共享 .mcp.json）。

真实运行结果

下面命令在隔离临时目录里实测通过：

1
2

Added HTTP MCP server fish with URL: https://fish.mcp.acedata.cloud/mcp to local config
fish: https://fish.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected

确认本机配置时可以运行：

1

claude mcp list

看到 fish: https://fish.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected 就说明 Fish 语音 MCP 已经接入成功。

使用示例

用 fish_generate_audio 把这段中文合成成 mp3，用默认音色

把这段英文合成成 wav，采样率 44100，使用音色 ID xxxx

把这段播客脚本合成成 mp3，bitrate 128，低延迟模式

工具

相关链接

• Fish Audio MCP Server（GitHub）
• Fish Audio MCP on PyPI
• Claude Code MCP Overview
• MCP 协议官网

Midjourney 拥有强大的图生图的功能，下面我们就来看一下，如何在我们的AceDataCloud网站上实现将照片切换成任意的二次元场景，同时保持人物的一致性。

我们可以按照如下的步骤去实现人物一致性。

下面我们来看看效果吧，原图如下。

以下风格均以原图为参考制作而成，可用于打造个性头像、趣味活动、特效类应用等场景，提升社交娱乐的体验。

1.欧美动漫风格

1

Midjourney提示词：欧美动漫风格，一位美丽的少女，身穿时尚的街头服饰，背景是现代都市的霓虹灯,Cartoon --version 6.1

2.港漫风格

1

港漫风格，一位勇敢的少女，身手不凡，背景是繁华的香港街景 --version 6.1 --stylize 411

3.韩漫风格—stylize 风格化

stylize 风格化的数值在 0-1000 之间，默认值为100。数值越小，越动漫化；数值越大，越具有艺术性。

1

韩漫风格，一位甜美的少女，背景是浪漫的咖啡馆 --version 6.1 --stylize 1000

1

韩漫风格，一位甜美的少女，背景是浪漫的咖啡馆 --version 6.1 --stylize 507

1

韩漫风格，一位甜美的少女，背景是浪漫的咖啡馆 --version 6.1

接下来，我们试试其他风格，—stylize同样适用。

4.迪士尼风格

1

迪士尼风格，一个女生，走在街上，8k --ar 1:1 --version 5.2

5.像素艺术风格

1

像素艺术，一位女孩以像素风格呈现，身穿色彩斑斓的服饰，背景是充满复古游戏元素的像素世界，8k --version 6.1

6.卡哇伊动漫风格

1

卡哇伊动漫风格，一个女孩微笑着，背景是梦幻的云朵与星星，8k --version 5.2

7.宫崎骏风格

1

宫崎骏风格，一位可爱的少女，拥有大大的眼睛和精致的发型，在河边，周围是五彩斑斓的樱花飘落,8k--version 6.1

8.京服咪动漫风格

1

京服咪动漫风格，一位穿着中国传统京剧服饰的少女，正在舞台上表演，背景是华丽的舞台布景，8k

9.国漫风格

1

国漫风格，园中少女，少女坐在池边，将脚伸入池中，背景有假山、瀑布和小树，精致的脸庞，美丽的眼睛，少女在伸懒腰，少女在 穿着汉服，浅蓝白相间的汉服， --version 6.1 --quality .5 --stylize 494

10.希腊神话风格

1

希腊神话，一位美丽动人的女神，常将自己披上绚丽的长袍，头上花环飘逸，她的微笑如同春风拂面，温柔而迷人，背景是希腊阿波罗神殿。 --version 6.1

11.Niji 5 模式下韩漫风格

Midjourney的Niji模式是一个专门训练用于生成动漫风格艺术的AI模型，它拥有丰富的动漫知识。最特别擅长创建动态和动感十足的镜头，并且非常注重角色和构图。在界面左上，选择Niji模式即可使用。

1

韩漫风格，一位甜美的少女，背景是浪漫的咖啡馆 --niji 5 --version 6.1

到这里就结束了吗？

不，远远没有。还有更多风格迥异的美图等你探索，别光收藏不练习，赶紧动手作图吧~

添加 AceDataCloud 官方微信，进群领取更多的 MidJourney 资料吧

市面上 AI 视频模型不少，但说到画质，Google Veo 排得上号。细节清晰、色彩自然，原生支持 1080p——生成完不需要再拿去超分辨率，直接用。

在 Cursor 里配上 Veo MCP Server，视频生成能力就直接嵌在你的开发环境里了。写代码的同时，一句话就能生成产品演示视频、社交媒体素材、文档配图动画。

获取 API Token

使用 Veo MCP Server 之前，你需要一个 AceData Cloud 的 API Token。获取方式非常简单：

1. 打开 AceData Cloud 平台，支持 GitHub、Google 或微信登录，注册后自动获得免费额度
2. 登录后，在首页即可看到你的 API Token，点击复制按钮即可获取

1. 如果额度用完，可以前往 控制台 充值，支持支付宝、微信和 Stripe

一个 Token 即可使用所有 MCP Server，无需为每个服务单独申请。

配置 Cursor

在项目根目录创建 .cursor/mcp.json：

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "veo": {
      "type": "http",
      "url": "https://veo.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer 你的Token"
      }
    }
  }
}

保存后 Cursor 会自动识别 MCP 配置，在 Agent 模式下即可使用 Veo 工具。

实战示例

文字生成视频

1

> 生成一段 1080p 的视频：一滴墨水落入清水中，慢慢扩散成不规则的形状，慢动作，电影质感

图片生成视频

有一张概念图，想让它”活过来”？

1

> 用这张产品截图作为参考，生成一段界面流畅切换的过渡动画

带音频生成视频

Veo 支持生成带有同步音频的视频，画面和声音一步到位：

1

> 生成一段带音频的视频：海浪拍打礁石，海鸥在上空盘旋，背景是日落

工具列表

其他编辑器配置

• VS Code — 在项目根目录创建 .vscode/mcp.json，使用 servers 作为顶层 key，其余配置相同
• Claude Code — 终端命令行配置，详见 Claude Code + Veo MCP 教程
• Claude Desktop — 详见 Claude Desktop + Veo MCP 教程

相关链接

• Veo MCP Server (GitHub)
• AceData Cloud 平台
• MCP 协议官网

做过海报的开发者都知道一个痛点：Midjourney 和 Flux 对中文的支持很一般。你让它写”限时优惠”四个字，出来可能是乱码或者不伦不类的笔画。

Seedream 是字节跳动做的 AI 图片模型，中文文字渲染是它的强项。你说”在图片右上角加上红色的限时优惠四个字”，它真的能做到。

如果你的目标受众是中文用户，Seedream 是比 Midjourney 更合适的选择。

第 1 步：在 VS Code 中搜索并安装插件

1. 打开 VS Code 扩展市场（Cmd+Shift+X）
2. 搜索 Seedream MCP，或直接搜索扩展 ID：acedatacloud.mcp-seedream
3. 点击 Install，安装后按提示重载窗口

第 2 步：获取并填写 API Key

1. 打开 Ace Data Cloud 控制台 / Applications
2. 复制你的 API Key（同一个 Key 可用于全部 Ace Data Cloud MCP）
3. 按 Cmd+Shift+P，执行：Seedream MCP: Set Ace Data Cloud API Key
4. 粘贴 API Key，回车保存（保存在 VS Code SecretStorage / 系统钥匙串）

如果要换 Key，可执行 Seedream MCP: Clear Ace Data Cloud API Key 后重新设置。

第 3 步：验证已连通

1. 打开 GitHub Copilot Chat，切到 Agent 模式
2. 直接提需求并点名 seedream，例如：用 seedream 帮我完成这个任务
3. 首次调用时会自动走到该插件并使用你保存的 API Key

进阶：手动 mcp.json（可选）

如果你更偏好手动配置，也可以在项目里写 .vscode/mcp.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

{
  "servers": {
    "seedream": {
      "type": "http",
      "url": "https://seedream.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer ${input:acedata-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "acedata-api-key",
      "type": "promptString",
      "description": "Ace Data Cloud API Key",
      "password": true
    }
  ]
}