这是一篇总览文章：把 AceData Cloud 提供的 11 个 MCP Server 一次性接到 Codex CLI，让 OpenAI 的开源终端编程工具在写代码之余顺手生图、写歌、做视频。

Codex CLI 是 OpenAI 官方推出的开源终端 AI 编程助手，原生支持 MCP。

AceData Cloud 提供哪些 MCP Server？

我们把以下能力封装成托管式远程 MCP Server，开箱即用：

一个 AceData Cloud Token = 全部 11 个 MCP Server，统一计费、按调用扣费，无月费。

为什么 Codex CLI + MCP

• OpenAI 官方维护，长期更新有保障
• 极简启动 codex，任何 shell 都能用
• 通过 MCP 调用 AceData Cloud，绕过模型本身的能力上限（写歌、生图、视频）

第 1 步：获取 API Token

1. 打开 AceData Cloud 平台，支持 GitHub、Google、微信、邮箱、手机号登录，注册即送免费额度。
2. 登录后首页就能看到你的 API Token，点击复制。

1. 余额不足时去 控制台 → 充值，支持支付宝、微信、Stripe。

第 2 步：在 Codex CLI 中添加 MCP

Codex CLI 用 TOML 格式的配置文件 ~/.codex/config.toml。在文件末尾追加：

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

[mcp_servers.suno]
url = "https://suno.mcp.acedata.cloud/mcp"
[mcp_servers.suno.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.midjourney]
url = "https://midjourney.mcp.acedata.cloud/mcp"
[mcp_servers.midjourney.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.flux]
url = "https://flux.mcp.acedata.cloud/mcp"
[mcp_servers.flux.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.seedream]
url = "https://seedream.mcp.acedata.cloud/mcp"
[mcp_servers.seedream.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.nanobanana]
url = "https://nanobanana.mcp.acedata.cloud/mcp"
[mcp_servers.nanobanana.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.luma]
url = "https://luma.mcp.acedata.cloud/mcp"
[mcp_servers.luma.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.sora]
url = "https://sora.mcp.acedata.cloud/mcp"
[mcp_servers.sora.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.veo]
url = "https://veo.mcp.acedata.cloud/mcp"
[mcp_servers.veo.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.seedance]
url = "https://seedance.mcp.acedata.cloud/mcp"
[mcp_servers.seedance.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.serp]
url = "https://serp.mcp.acedata.cloud/mcp"
[mcp_servers.serp.headers]
Authorization = "Bearer 你的Token"

[mcp_servers.shorturl]
url = "https://shorturl.mcp.acedata.cloud/mcp"
[mcp_servers.shorturl.headers]
Authorization = "Bearer 你的Token"

替换 你的Token 后保存，下次启动 codex 时所有 MCP Server 自动加载。

第 3 步：试一试

配置完成后，重启编辑器 / CLI，让它重新加载 MCP Server。然后就可以这样用：

例 1（写完 PR 后生成 cover 图）：

用 Flux 生成一张 GitHub PR 封面，主题是”开源协作”，1280x640。

例 2（写技术博客时找资料）：

用 Serp 搜 “OpenAI Codex CLI tutorial 2026” 前 5 条最新文章。

例 3（demo 视频 BGM）：

用 Suno 写 45 秒平静钢琴曲做开发者教程 BGM。

计费与额度

• 按次扣费，不调用不花钱，无月费、无最低消费。
• 同一 Token 在所有 MCP Server 之间共享额度。
• 所有调用记录、剩余额度、消费明细可在 控制台 查看。
• 大用量需求可联系商务，享受批量价格。

常见问题

Q：可以只接入其中几个 MCP Server 吗？
A：当然，按需添加配置即可，没用到的就不加。

Q：有没有更便宜的接入方式？
A：直接调用 REST API 比 MCP 更便宜（少一层封装），但失去 MCP 在 LLM 工具调用上的便利。

Q：海外 / 跨境延迟问题？
A：所有 MCP Server 部署在香港，全球访问稳定；中国大陆直连无需代理。

Q：支持自托管吗？
A：MCP Server 全部 开源在 GitHub，可自行部署。

相关链接

• AceData Cloud 平台首页
• 所有 MCP Server 列表
• REST API 文档
• 完整应用案例

📘 完整指南：在 Claude.ai 网页版里用全部 11 个 AceData Cloud MCP →

想让 Claude 直接出图？不用切到 Discord，不用记 /imagine 命令，不用调任何参数。在 Claude.ai 聊天框里随手敲一句英文 prompt，Claude 自己会去调用 Midjourney，几十秒后把 2×2 网格图、放大、变体一并丢回来。

本文是一篇亲手在 Claude.ai 网页版跑通的实测记录：从添加 Connector、OAuth 授权，到一句 prompt 生成完整 16:9 网格图，全程截图，复制即可复现。

什么是 MCP？

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

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

• 从文字描述生成 Midjourney 2×2 网格图
• 放大（Upscale）任意一张到高分辨率
• 生成同主题的变体（Variations）
• 重新生成（Reroll）
• 局部修改（Vary Region / Inpaint）
• 缩放、扩图（Zoom Out / Pan）
• 翻译中文 prompt、补全 prompt
• 查询任务状态、获取历史结果

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

在 Claude.ai 网页版添加 Midjourney 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. 添加 Midjourney MCP Server

点击 Add custom connector，在弹出对话框里填：

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

3. OAuth 授权

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

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

授权完成后回到 Claude.ai，点开 Midjourney Connector，能看到 Imagine / Upscale / Variation / Reroll / Pan / Zoom / Vary Region / Translate / Get Task 等十多个工具：

⚙️ 强烈建议把每个工具下拉切换到 Always allow，否则每次工具调用都会弹确认框。生成一张图通常会触发 2–4 次工具调用（提交 + 多次查询状态），点确认到怀疑人生。

实测：一句英文 Prompt 出图

下面是我真实跑出来的对话，提示词是英文（Midjourney 对英文 prompt 理解更稳定）：

Prompt: Use Midjourney to generate one image of a futuristic cyberpunk city skyline at night, neon lights reflecting on wet streets, cinematic, 16:9 aspect ratio.

Claude 收到后做的事情：

1. 自动调用 imagine_midjourney，带上 prompt 和 --ar 16:9
2. 拿到 task id，自己开始轮询 get_midjourney_task
3. 约 1 分钟左右拿到 2×2 网格图（4 张候选），分辨率 2912×1632
4. 把图片链接 + 文字总结一次性贴回聊天框，附带”要 upscale 哪张？要 variation 吗？”的后续提示

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

实际生成的 2×2 网格图（直接落到 platform.cdn.acedata.cloud，长期可用）：

💡 图片链接是稳定的：AceData Cloud 把 Midjourney 出来的图直接搬到自己的 CDN（platform.cdn.acedata.cloud/midjourney/<id>.png），不像直连 Discord CDN 那样会过期。Claude 返回的链接可以直接贴到博客、PPT、设计稿里。

更多玩法（同样一个 Connector）

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

放大其中一张到高清

1

Upscale the top-left panel.

→ Claude 调用 upscale 工具，把第 1 张拉到约 5824×3264。

生成变体

1

Generate variations of the bottom-right one.

→ Claude 调用 variation 工具，再出 4 张同主题候选。

改局部 / 重画一部分

1

Take the upscaled image and replace the sky with a giant orange moon.

→ Claude 调用 Vary Region / inpaint 系列工具。

扩图 / 横向延展

1

Zoom out 2x to show more of the city below.

→ Claude 调用 Zoom Out。

纯英文 prompt 翻译

1
2

Translate this Chinese MJ prompt to English first, then generate it:
"赛博朋克风格的雨夜上海外滩"

→ Claude 先调 translate_midjourney_prompt 把中文转成 Midjourney 友好的英文，再 imagine。

常见问题

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

Q：余额不够怎么办？
A：错误信息里会带 insufficient balance。去 https://platform.acedata.cloud/console/coin 充值，支持支付宝 / 微信 / Stripe / USDC。生成一张网格图通常消耗几个 credit，新账号免费额度足够测几次。

Q：可以和别的 MCP 一起用吗？
A：可以。Claude.ai 支持多 Connector 并存。一句 “用 Midjourney 出一张赛博朋克城市图，然后用 Suno 写一首匹配这张图氛围的歌” 就能让 Claude 自己编排图像 + 音乐流水线。完整列表见 Claude.ai × 11 个 MCP 总览。

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

相关链接

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

想要一条“看起来就贵”的视频，以前意味着大量人力：分镜、拍摄、灯光、后期……时间长、成本高。Ace Data Cloud 的 Veo Videos API 让事情变得不同：

• 文生视频（text2video）：把你的镜头设想直接写成提示词；
• 图生视频（image2video）：用一张或多张参考图，生成自然衔接的动态；
• 1080p 升级（get_1080p）：对已生成视频再次升级清晰度；
• 多模型选择：veo2/veo2-fast/veo3/veo3-fast，在质量与速度间自由取舍。

关键链接

• 文档页：Veo Videos Generation API https://platform.acedata.cloud/documents/63e01dc3-eb21-499e-8049-3025c460058f
• 接口：POST https://api.acedata.cloud/veo/videos

可视化参数与界面示意

• 基本参数与模型选择：
• 自动生成代码视图：

一、案例合集（每个案例都含请求、返回与“可播放链接/字段”）

案例 1：文生视频（text2video）拍“旋转咖啡杯”的开场镜头

• 场景与镜头语言：主体白瓷咖啡杯、光滑大理石台面、清晨窗光、镜头缓慢 360° 围绕、把手处稍作停顿、节奏从容细腻。
• 输入（cURL）

1
2
3
4
5
6
7
8
9

curl -X POST 'https://api.acedata.cloud/veo/videos' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "action": "text2video",
    "model": "veo2",
    "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle."
  }'

• 输出（节选）

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

{
  "success": true,
  "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

案例 2：图生视频（image2video）让静态海报“活起来”

• 用法：给现有 KV/海报做 5–8 秒的动态延展，用于短视频开场与社媒循环播放。
• 输入（Python，节选）

1
2
3
4
5
6
7
8
9
10

import requests
url = "https://api.acedata.cloud/veo/videos"
headers = {"accept": "application/json","authorization": "Bearer {token}","content-type": "application/json"}
payload = {
  "action": "image2video",
  "model": "veo2",
  "prompt": "Let it dance",
  "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}
print(requests.post(url, json=payload, headers=headers).text)

• 输出（节选）

1
2
3
4
5
6
7
8
9
10
11

{
  "success": true,
  "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4",
      "state": "succeeded"
    }
  ]
}

• 表单填写与自动生成代码界面（示意）：

案例 3：1080p 升级（get_1080p）让“胜出版本”更清晰

• 背景：A/B 后选出表现最好的视频，升级到 1080p 用于投放或大屏播放。
• 查找 video_id（界面示意）：
• 输入（cURL）

1
2
3
4
5
6
7
8
9

curl -X POST 'https://api.acedata.cloud/veo/videos' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "action": "get_1080p",
    "model": "veo2",
    "video_id": "59f12222b1fa4fbe9331ff2400ad1583"
  }'

• 输出（节选）

1
2
3
4
5
6
7
8
9
10
11

{
  "success": true,
  "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4",
      "state": "succeeded"
    }
  ]
}

案例 4：品牌栏目片头模板化（多模型与参数切换）

• 做法：

  • 文案模板：

    1	"<brand keywords> opening sequence, logo reveal with dynamic light streaks, camera push-in then slow orbit, elegant, premium, cinematic lighting"

  • 模型策略：veo2-fast 先快速验证、veo3/veo3-fast 出高质量版本；

  • 比例适配：横版/竖版封面双版本，便于多渠道分发。

案例 5：产品短片（雾面玻璃手机 + 背景流光）

• Prompt（可复用）：

1

"matte glass smartphone floating above a minimal pedestal, moody rim light, soft volumetric glow, background light trails sweeping left to right, 6-second loop, camera slow dolly-in, cinematic"

• 路径：先 text2video → 若出现理想关键帧，导出为首帧再试 image2video。

二、常见工作流（从灵感到成片）

1. 写镜头语言：主体/光线/机位/运动/节奏；
2. 生成多个版本做“眼缘筛选”与小额投放测试；
3. 胜出版本做 1080p 升级；
4. 素材落库：保存 video_url、model、prompt、created_at、complete_at 等字段；
5. 形成“镜头模板库”，后续按主题套用。

三、提示词与参数技巧（更稳更像你想要的）

• 镜头：slow orbit、dolly-in、pan、tilt、rack focus、time-lapse；
• 光线：golden hour、studio lighting、rim light、soft glow、volumetric；
• 质感：matte、glossy、aluminium、velvet、ceramic；
• 节奏：slow/fast, loop, 3–6 seconds；
• 模型策略：veo2-fast 探索、veo3-fast 上量、veo3 上质。

四、开发者速通（3 步接入）

1. 在文档页点击 Acquire 获取凭证（一般附带免费额度）。
2. 调用 POST /veo/videos：传 action、model、prompt/image_urls/video_id；
3. 关注返回：video_url 成品链接、created_at/complete_at 用于排期追踪。

五、典型落地场景

• 品牌与广告：开场片头、节日主题片、产品镜头；
• 媒体与创作者：栏目包装、Logo 动效、封面循环背景；
• 产品与 UI：App/网站/线下屏的高级动效背景。

六、合规与建议

• 版权与素材：确保参考图片/元素具有合法使用权限；
• 平台规范：遵守分发渠道的视频规范与内容政策；
• 成本优化：先用 fast 模型验证方向，成片再升质量与清晰度。

现在就把“看上去很贵”，变成“人人配得起”

• Veo 文档页：https://platform.acedata.cloud/documents/63e01dc3-eb21-499e-8049-3025c460058f
• 接口：POST https://api.acedata.cloud/veo/videos

适合谁

• 品牌与广告：
  • 做“带镜头”的产品短片，旋转、跟拍、推拉摇移都能准确描述；
  • 节日与节点活动，快速形成有质感的主视觉视频。
• 媒体与创作者：
  • 做栏目片头/片尾，用同一套镜头语言形成稳定识别；
  • 以静帧作画，再生成动态，保持风格统一。
• 产品与 UI：
  • 为 App/网站/线下屏制作高端动效背景，显著提升“第一观感”。

你的第一条电影感短片，这么写

提示词建议包含：主体 + 场景 + 光线 + 镜头运动 + 节奏

示例：

• “白瓷咖啡杯放在光滑的大理石台面上，清晨的窗光洒入，镜头缓慢围绕杯身 360° 旋转，在把手处稍作停顿，节奏从容，质感细腻。”

这正是 Veo 擅长的表达方式：你说镜头，它就给你镜头。

工作流范式

1. 文生视频：把镜头语言写清楚，一次生成多个版本；
2. 图生视频：用首尾帧或关键画面，生成逻辑更清晰的动态；
3. 升级 1080p：对“胜出版本”做高清升级，用于投放或大屏播放；
4. 落库分发：把 video_url、created_at、model 等信息归档，形成复用资产。

接入流程

1. 在 Ace Data Cloud 平台打开 Veo 文档页，点击 Acquire 获取凭证（一般附带免费额度）；
2. 发起任务：设置 action（text2video/image2video/get_1080p）、选择 model，传入 prompt 或 image_urls；
3. 结果回调：生成需要时间，建议配置 callback_url，自动接收 video_url 成品。

真实片段

一家咖啡品牌用 Veo 生成“旋杯”短片，上线首页与门店竖屏；同主题做四季版本（清晨/午后/雨夜/雪日），配合文案轮播，线下停留时长与线上点击率同步上升。

把看上去很贵，变成人人配得起

进入 Ace Data Cloud，开通 Veo API。写下你的第一条镜头指令，下一支高质感短片，从今天开始。

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

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

请求示例

Nano Banana Tasks API 可以用于查询 Nano Banana Images API 的结果。关于怎样使用 Nano Banana Images API，请参考文档 Nano Banana Images API 。

我们以 Nano Banana Images API 服务返回的任务 ID 一个为例，演示如何使用该 API。假设我们有一个任务 ID：4d320ead-4af4-4a55-8f3e-f2afebdf4fd0，接下来演示如何通过传入一个任务 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/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "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/nano-banana/tasks"

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

payload = {
    "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "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

{
  "_id": "68bc7c3c550a4144a53d0e24",
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
  "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
  "created_at": 1757183036.787,
  "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
  "request": {
    "action": "generate",
    "prompt": "a white siamese cat"
  },
  "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
  "type": "images",
  "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
  "response": {
    "success": true,
    "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
    "data": [
      {
        "prompt": "a white siamese cat",
        "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
      }
    ]
  }
}

返回结果一共有多个字段，request 字段就是发起任务时的 request body，同时 response 字段是任务完成后返回的 response body。字段介绍如下。

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

批量查询操作

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

Request Body 包括：

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

示例如下：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed","1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"],
  "action": "retrieve_batch"
}'

响应示例

请求成功后，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

{
  "items": [
    {
      "_id": "68bc7c3c550a4144a53d0e24",
      "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
      "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
      "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
      "created_at": 1757183036.787,
      "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
      "request": {
        "action": "generate",
        "prompt": "a white siamese cat"
      },
      "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
      "type": "images",
      "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
      "response": {
        "success": true,
        "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
        "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
        "data": [
          {
            "prompt": "a white siamese cat",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

返回结果一共有多个字段，其中 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"
}

结论

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

AceDataCloud 平台把所有可调用的功能模块抽象为「服务（Service）」——例如 Midjourney 出图、OpenAI 对话、Suno 出歌、Veo 出片、Web 抓取、SERP 搜索等。本接口返回平台上全部可申请的服务清单，每条记录包含名称、定价规则、免费额度、可选套餐、关联的 API/Proxy 端点等完整信息。

通过本接口你可以：

• 在你自己的产品里嵌一个”服务市场”页面，让用户从中挑选。
• 给 LLM Agent 喂一份能力清单，由它决定调哪个服务。
• 写定时脚本监控价格 / 套餐变化。

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

接口概览

鉴权说明

本接口完全公开，任何人都可以调用，无需账户令牌或登录态。

💡 但是：如果带上账户令牌，响应里的 applied 字段会变成 true/false（表示你是否已申请该服务），而不是恒为 false。这对前端”已申请 / 立即申请”按钮的二态切换非常方便。

1

Authorization: Bearer platform-v1-92eb****629c   # 可选

账户令牌的获取方式见管理 AceDataCloud 平台账户令牌。

查询参数

请求示例

cURL

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

# 不带鉴权，获取前 2 个 Api 类型服务
curl 'https://platform.acedata.cloud/api/v1/services/?type=Api&limit=2' \
  -H 'accept: application/json'

# 带鉴权，看 applied 状态
curl 'https://platform.acedata.cloud/api/v1/services/?type=Api&limit=5' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

# 按 alias 精准查询
curl 'https://platform.acedata.cloud/api/v1/services/?alias=midjourney' \
  -H 'accept: application/json'

Python

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

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/services/",
    headers={"accept": "application/json"},
    params={"type": "Api", "limit": 20, "ordering": "-applied_count"},
    timeout=10,
)
data = resp.json()
print(f"共 {data['count']} 个 Api 服务，按热度倒序")
for svc in data["items"]:
    print(f"  {svc['title']:30s}  {svc['applied_count']:>6} 人申请  {svc['free_amount']} {svc['unit']} 免费")

Node.js

1
2
3
4
5

const params = new URLSearchParams({ type: 'Api', limit: '20', ordering: '-applied_count' })
const r = await fetch(`https://platform.acedata.cloud/api/v1/services/?${params}`)
const { count, items } = await r.json()
console.log(`共 ${count} 个服务`)
items.forEach((s) => console.log(`${s.title} (${s.alias})  免费 ${s.free_amount} ${s.unit}`))

响应示例（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
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

{
  "count": 42,
  "items": [
    {
      "id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
      "alias": "face-transform",
      "title": "人脸变换",
      "description": "人脸识别、替换和风格转换等操作服务。",
      "introduction": "",
      "type": "Api",
      "applied": false,
      "applied_count": 281,
      "free_amount": 1.0,
      "unit": "Credit",
      "private": false,
      "need_verify": false,
      "rank": 0,
      "tags": [],
      "metadata": null,
      "thumbnail": "https://cdn.acedata.cloud/qrd7gw.png/thumb_600x300",
      "doc_url": null,
      "demo_url": null,
      "api_ids": [
        "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
        "2c7f6468-58d9-4611-885b-1e34664d49e9"
      ],
      "proxy_ids": [],
      "cost": [
        { "conditions": { "==": [1, 1] }, "consumption": 0.0025 }
      ],
      "packages": [
        {
          "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
          "type": "Usage",
          "price": 63.2,
          "amount": 530.0,
          "duration": null,
          "private": false,
          "tags": [],
          "metadata": null,
          "created_at": "2024-12-19T13:57:46.525377Z",
          "updated_at": "2024-12-19T13:57:46.525394Z"
        }
      ],
      "created_at": "2024-06-11T00:41:29.255614Z",
      "updated_at": "2026-04-26T16:12:40.481154Z"
    }
  ]
}

响应字段说明

错误处理

公开接口几乎不会出错。常见非 200 情况：

错误响应格式：

1
2
3
4
5

{
  "detail": "Invalid value for parameter 'type'.",
  "code": "invalid",
  "trace_id": "5b0f15d6e9c34c9c93d6d0f4f3a8c8d7"
}

实用提示

• 筛选服务最高效的方式是 alias，不是 id：服务 ID 是 UUID，不便于硬编码到代码里。
• type=Api 是最常用的过滤：90% 用户只关心 Api 类型；Integration 是组合工作流，Dataset 是只读数据集，Proxy 是 OpenAI 兼容转发。
• packages 字段返回价格但不含折扣：实际下单时如果使用 X402 加密货币支付或持有 $ACE 代币，会在创建订单时再次计算最终金额。详见创建 AceDataCloud 平台充值订单 与 查询 AceDataCloud 平台 $ACE 代币持仓与折扣。
• 本接口数据量较大（每条记录可能含数 KB 的 introduction Markdown）：在客户端做长列表时建议传 limit=20 分页加载，而不是一次拉完整。

相关接口

• 获取 AceDataCloud 平台服务详情 — 看单个服务的完整定义（含 OpenAPI Schema）
• 获取 AceDataCloud 平台服务下的 API 列表
• 获取 AceDataCloud 平台服务下的 Proxy 列表
• 创建 AceDataCloud 平台服务申请 — 选定后点”申请”
• 获取 AceDataCloud 平台模型列表 — OpenAI 风格的 /v1/models 视角

Wisdom 是一个把微信桌面客户端封装成 HTTP / MCP API 的自动化服务,在 AceDataCloud 平台以独立的腾讯云 CVM 实例形式按租户独立部署。

适用场景

• 自动化收发微信消息、群消息(基于 FastAPI 接口)
• 把微信对话接入 LLM Agent、MCP 客户端、Coze 等编排平台
• 替代「群发助手」「客服机器人」类第三方工具,自有可控、私有部署

部署形态

每次「部署」会在腾讯云开通一台 Windows CVM:

• 镜像:预装 dockur/windows + Wisdom Docker 镜像
• 启动后自动从 C:\wisdom\.env 读取平台下发的 WISDOM_API_TOKEN
• 公网 IP + 端口 8000,通过 ?token= 鉴权

控制台会展示:

• 访问地址:http://<公网 IP>:8000?token=<API Token>
• MCP 接入片段:一键复制 WISDOM_API_URL / WISDOM_API_TOKEN,粘进 Cursor / Claude Desktop 即可调用

套餐规格

部署费按月计算,覆盖 CPU/内存/磁盘/带宽,实例停机仍按月计费(腾讯云对停机实例的磁盘和保留 IP 仍有收费)。

文档

详细 API 与认证说明见 Wisdom 仓库 SPEC.md。

为已有凭证重新签发一个新的 Token——凭证的 ID 不变、限额/过期/IP 白名单/调用历史不变，只是 Token 明文换了。

适合场景：怀疑 Token 泄露、定期合规轮换、人员离职等。比”删了再新建”省事，因为不需要再去业务侧改 application_id 关联。

⚠️ 与创建接口一样，完整 Token 明文只在本接口的响应中返回一次。务必当场保存。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。

接口概览

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

请求头：

1

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

获取方式见管理 AceDataCloud 平台账户令牌。

路径参数

请求示例

cURL

1
2
3

curl -X POST 'https://platform.acedata.cloud/api/v1/credentials/df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6/rotate/' \
  -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

import requests

cred_id = "df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6"
resp = requests.post(
    f"https://platform.acedata.cloud/api/v1/credentials/{cred_id}/rotate/",
    headers={
        "accept": "application/json",
        "authorization": "Bearer platform-v1-92eb****629c",
    },
    timeout=10,
)
cred = resp.json()
print(f"✅ 新 Token: {cred['token']}")
print(f"凭证 ID 保持不变: {cred['id']}")

Node.js

1
2
3
4
5
6
7
8
9
10

const credId = 'df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6'
const r = await fetch(
  `https://platform.acedata.cloud/api/v1/credentials/${credId}/rotate/`,
  {
    method: 'POST',
    headers: { authorization: 'Bearer platform-v1-92eb****629c' },
  }
)
const cred = await r.json()
console.log('新 Token:', cred.token)

响应示例（HTTP 200）

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

{
  "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": "ac9999999999999999999999999999ffff",
  "amount": 50.0,
  "used_amount": 12.34,
  "remaining_amount": 37.66,
  "disabled": false,
  "expired_at": "2026-12-31T23:59:59Z",
  "tags": ["prod"],
  "metadata": null,
  "client_ip_allowlist": ["203.0.113.7/32"],
  "used_at": "2026-04-26T08:30:00Z",
  "created_at": "2026-04-26T07:55:00Z",
  "updated_at": "2026-04-26T10:12:00Z"
}

注意 id 不变、token 已被新值替换。轮换瞬间旧 Token 立即失效。

错误处理

实用提示

• 轮换是原子操作：新 Token 在响应返回时已经生效，旧 Token 已经失效。不存在两个 Token 同时有效的过渡期。
• 零停机轮换：把”调用方先用新 Token 重试一次”作为应急保底——比如把”401 → fetch 最新 Token → 重试”内置到业务客户端里。
• 不要在没办法立即更新业务侧 Token 时轮换：旧 Token 会立刻失效。如果业务侧无法迅速换 Token，先用 disabled=true 软关停（PATCH 当前还不开放，可走删除）。
• 轮换不影响：限额（amount）、过期时间（expired_at）、IP 白名单、调用历史、标签、元数据。

相关接口

• 创建 AceDataCloud 平台 API 凭证
• 获取 AceDataCloud 平台 API 凭证列表
• 删除 AceDataCloud 平台 API 凭证

本文将介绍一种 Fish Audios Generation API 对接说明，它是可以通过输入提示词来克隆自己的音色。

申请流程

要使用 API，需要先到 Fish Audios Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

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

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

首先先了解下基本的使用方式，就是输入提示词 prompt、 克隆行为 action、音色ID voice_id 以及模型 model，便可获得处理后的结果，首先需要简单地传递一个 action 字段，它的值为 generate，然后我们还需要输入模型 model，目前主要有 fish-tts 模型，具体的内容如下：

可以看到这里我们设置了 Request Headers，包括：

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

另外设置了 Request Body，包括：

• model：克隆声音的模型，主要有 fish-tts 模型。
• action：此次声音克隆任务的行为。
• prompt：需要克隆的提示词。
• voice_id：根据音色ID来进行克隆。
• callback_url：需要回调结果的URL。

选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：

1
2
3
4
5
6
7
8
9
10

{
  "success": true,
  "task_id": "5872ab00-3cf4-4040-a798-8510aaa16756",
  "trace_id": "5eda3694-448a-4b72-af33-2acb3851ffe1",
  "data": [
    {
      "audio_url": "https://platform.r2.fish.audio/task/8a72ff9840234006a9f74cb2fa04f978.mp3"
    }
  ]
}

返回结果一共有多个字段，介绍如下：

• success，此时克隆声音任务的状态情况。
  • data，克隆声音任务的结果
    • audio_url，此时克隆声音任务音频链接结果。

可以看到我们得到了满意的声音信息，我们只需要根据结果中 data 的音乐链接地址获取克隆好的声音即可。

另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

1
2
3
4
5
6
7
8
9
10

curl -X POST 'https://api.acedata.cloud/fish/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "speech",
  "prompt": "a white siamese cat",
  "model": "fish-tts",
  "voice_id": "d7900c21663f485ab63ebdb7e5905036"
}'

异步回调

由于 Fish Audios Generation API生成的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成任务的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/4815f79f-a40f-4078-ac85-1cc126b6bb34。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入相应的参数，具体的内容如图所示：

点击运行，可以发现会立即得到一个结果，如下：

1
2
3

{
  "task_id": "2725a2d3-f87e-4905-9c53-9988d5a7b2f5"
}

稍等片刻，我们可以在 https://webhook.site/4815f79f-a40f-4078-ac85-1cc126b6bb34 上观察到生成任务的结果，如图所示：

内容如下：

1
2
3
4
5
6
7
8
9
10

{
    "success": true,
    "task_id": "2725a2d3-f87e-4905-9c53-9988d5a7b2f5",
    "trace_id": "e2d308bc-4df8-4c69-9369-a60f3c54f2b3",
    "data": [
        {
            "audio_url": "https://platform.r2.fish.audio/task/b627c2f7d38a4083a837570ba6d0962f.mp3"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

在调用 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"
}

结论

通过本文档，您已经了解了如何使用 Fish Audios Generation API 可通过输入提示词来克隆声音。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

本接口基于 Fish Audio 官方 Model API，用于按 _id 查询单个克隆音色的完整详情。地址为 GET https://api.acedata.cloud/fish/model/{id}。

创建音色请参考 Fish Model Create API；分页检索请参考 Fish Model Query API。

申请流程

要使用 API，需要先到 Fish Model API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮。

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

在首次申请时会有免费额度赠送，可以免费使用该 API。

路径参数

无请求体、无查询参数。

示例：拉取一个公开西班牙语音色的完整详情

1
2

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

返回（实测，删去了 samples[].audio 中的签名 query string 以便阅读）：

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

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "A mature and authoritative male voice with a calm, spiritual tone. It is well-suited for religious narration, educational content, and professional storytelling in Spanish.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "male", "old", "narration", "calm", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Default Sample",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

拿到的 _id 直接喂给 Fish TTS 的 reference_id 即可合成相同音色的语音：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

与列表接口的差异

如果只是要试听一下，列表接口里的 samples[].audio 已经够用；要更稳定的下载链接，建议改用本接口。

响应字段（节选）

计费说明

本接口不计费——按 ID 查询单个音色详情是免费操作，仅 Fish Model Create 在请求体携带 voices 字段创建新音色时计费。

错误处理

• 400 token_mismatched：路径中的 id 不是合法格式，或上游报「Model not found」。
• 401 invalid_token：鉴权 token 不存在或无效。
• 404 not_found：指定 _id 在 Fish 上游不可见（音色被删除、私密、或属于其他账号）。
• 429 too_many_requests：触发账号速率限制。
• 500 api_error：服务器内部错误。

实际请求一个不存在的 ID 时上游会直接返回 400 Model not found（实测）：

1
2

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

返回：

1

{ "status": 400, "message": "Model not found" }

错误响应示例：

1
2
3
4
5
6
7
8

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

结论

知道音色 _id 时直接用本接口拿完整 ModelEntity，最常见的用法是：(1) 试听 samples[].audio，(2) 把 _id 喂给 /fish/tts 的 reference_id 完成合成。如果只有标题或标签，请先用 Fish Model Query 检索。

AI 时代来了，很多人已经用 AI 赚的盆满钵满了，可能很多朋友也想加入这个浪潮，但感觉 AI 离自己很远不知道怎么切入。 不用担心，这篇文章会介绍一个零成本无风险帮助你用 AI 赚钱的方法，大家快来试试吧！仔细看下面的文章。

如果你已经被“AI 很赚钱”刷屏，但不知道从哪下手——这篇就是写给你的。
不用囤货、不用投入、不会写代码也行；

为啥这件事对你友好？

• 零成本、低门槛：不压钱、不备货、不做售后。
• 长期收益：客户永久绑定到你名下，后续每一笔消费你都分成。
• 平台兜底：技术、产品、支付、风控、客服都由平台完成，你只管推广与分发。
• 可全球开展：支持全球收款与多币种结算，你可以面向世界做内容。

这是什么平台？（一分钟读懂）

Ace Data Cloud 是一个面向企业与个人的 AI 服务平台，提供：

• 给企业/开发者的 API
  AI 问答（OpenAI、DeepSeek 等）、AI 图片（Midjourney、Flux）、AI 音乐（Suno）、AI 视频（Luma、Pika）、HTTP 代理（移动/住宅/全球代理）、数据集等。
  👉 查看全部服务与文档：https://platform.acedata.cloud

• 给个人创作者的可用网站
  不懂技术也能用网页版体验 AI 问答/图片/音乐/视频，支持电脑和手机、微信/谷歌/GitHub 登录与支付。
  👉 一站式体验：https://studio.acedata.cloud

• 给“想自己做站”的人
  平台把前端 UI 完全开源（项目名 Nexior）。几分钟就能搭好你自己的 AI 网站，对外售卖、自己定价。
  👉 开源仓库：https://github.com/AceDataCloud/Nexior

怎么赚钱？（本质就三条路）

你做的事只有一件：邀请用户注册并消费。
客户一旦通过你的链接注册，永久成为你的下级。他在 Ace Data Cloud 全站的每一次付费，都会按你的分成比例计算现金奖励，可随时提现。

举个真实可感的例子（以 15% 分成为例）：

1. 客户在 platform.acedata.cloud 购买 API 套餐 A：$1000
   → 你得 $150。
   他 10 天后又买了 B：$2000
   → 你再得 $300。
   后续每买一次，你都继续拿分成。

2. 同一个客户在 studio.acedata.cloud 里订阅了 C：$500
   → 你再得 $75。
   后续订阅/续费，继续拿。

3. 你用 Nexior 搭了自己的站点（例如 https://ai-example.com），并接上 Ace 的用户系统；
   你在自己站里又带来 100 个付费用户，每人 $100：
   → 你直接拿 100 × $100 × 15% = $1500。

要点：三个入口（开发者 API、个人网页、你自建站）统一用户体系，一个客户在任何入口的付费，都算你的分成。

这事儿真的有人在赚吗？

有伙伴后台实打实的截图：

• 推荐订单总金额约 ¥90 万+
• 推荐总奖励 ¥16.8 万+
• 邀请人数 3200+
  （不同人结果会因投入与渠道差异而不同，但这条路确实跑得通。）

5 分钟加入：新手三步走

第 1 步：注册
打开 https://platform.acedata.cloud，用邮箱/手机/微信/GitHub/Google 任意一种登录即可。

第 2 步：领取你的专属链接
进入「创收联盟」后台：https://platform.acedata.cloud/console/distributions
你能看到当前分成等级、收益明细、邀请链接与二维码。

第 3 步：发布链接开始引流
把链接/二维码放到你的朋友圈、社群、知乎、B 站、公众号、抖音/小红书、GitHub README……
有人通过你的链接注册并消费，你就能在后台看到收益增长，随时提现（有客服协助）。

给你一套可复制的推广打法

推荐先从一个你最熟的垂直场景入手，比如“电商设计图”、“短视频脚本”、“AI 音乐/BGM”、“AI 论文润色”、“编程问答”等。

A. 直接用平台做内容，顺手引导注册

• 做几张 AI 图片对比（原图 vs 换装/换景效果），配文写清流程与成本；
• 录一个 AI 视频生成的教程短视频；
• 发一篇 AI 问答实战（比如“如何 3 小时做完论文综述”）；
  文末放你的邀请链接 + 简短引导：

B. 各平台模板 & 教程（官方已备好）

• 知乎：https://platform.acedata.cloud/earning/zhihu-promotion
• 掘金：https://platform.acedata.cloud/earning/cd0140d4-d2e3-4ba8-a8b2-11ff18ea52e1
• CSDN：https://platform.acedata.cloud/earning/dd6ac91f-f9a0-48ba-8866-12fea199dd9c
• GitHub：https://platform.acedata.cloud/earning/807af0d6-951e-44df-ad6d-2afdba6e355f
• 一键搭站指南：https://platform.acedata.cloud/earning/5b942c64-5612-4aab-ab3c-9e58b64cb069
• 各类推广文案模板：https://platform.acedata.cloud/earning/e3653560-6d78-43bf-b071-88f036cf75b7

你关心的几个问题（Q\&A）

Q1：真的零成本吗？需要囤货或先充值吗？
A：不需要。 你只负责推广。产品、服务、支付、售后都由平台负责。

Q2：客户为什么会绑定在我名下？会不会被别人抢走？
A：通过你的专属链接/二维码注册后，客户将永久绑定到你名下。该客户在平台任何入口的消费都计算你的分成。

Q3：我不会写代码，能做吗？
A：完全可以。你可以直接推广 可视化网页 studio.acedata.cloud 给普通用户；面向开发者时再推广 API。

Q4：可以全球做吗？提现麻烦吗？
A：支持全球收款与多币种。后台可查看收益明细，联系客服即可提现。

Q5：怎么提高转化？
A：内容里给出可见结果（前后对比、真实用例），并附上清晰步骤 + 你的答疑承诺；引导读者先免费体验，再升级付费。

写给已经想试一试的你

不要等到“我准备好了再开始”。这条路的门槛已经被平台降得足够低：

• 你不用做技术；
• 你不用有库存；
• 你只需要把真实有用的内容分享给可能需要的人。
  今天发出第一条内容，明天后台就可能出现第一笔收益。

👉 现在就去：https://platform.acedata.cloud 注册
👉 打开「创收联盟」：https://platform.acedata.cloud/console/distributions 领取你的专属链接

还是拿不准？
来这里加微信：https://platform.acedata.cloud/support，备注「创收联盟」，免费进群，我们手把手教你启动、陪跑到出单。

NanoBanana 跟其他 AI 画图工具不太一样——它不只是”画一张新图”，更强的是”改一张旧图”。底层用的是 Google Gemini 模型，真正理解图片内容，可以精确编辑。

最实用的能力：扔给它两张图，让它把 A 图的产品放到 B 图的背景上，或者以 A 图的风格重画 B 图。现在通过 MCP 协议，Cursor 里一句话就能调用。

获取 API Token

使用 NanoBanana 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": {
    "nanobanana": {
      "type": "http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer 你的Token"
      }
    }
  }
}

保存后重启 Cursor，在 Agent 模式下即可使用 NanoBanana 的图片生成和编辑功能。

真实开发场景

“把这张截图美化一下”

你录了一张丑丑的终端截图，想放到博客里但嫌太素：

1

> 编辑这张图片，添加一个圆角阴影的窗口装饰，背景换成浅灰色渐变

多图合成

产品经理给了你一张产品图和一张场景图，要合成一张”产品在场景中使用”的效果图：

1

> 把第一张图中的手机放到第二张图的桌面上，调整大小和透视角度让它看起来自然

nanobanana_edit_image 支持传入多张图片 URL，AI 看得懂图片关系。

404 页面等趣味插画

1

> 生成一只小恐龙趴在破碎的地面裂缝边上往下看的插画，用作 404 页面

NanoBanana Pro 模型画插画质量不错，风格多变。

工具列表

其他编辑器配置

• VS Code — .vscode/mcp.json，servers 下同样配置
• Claude Code — 终端命令行配置，详见 Claude Code + NanoBanana MCP 教程
• Claude Desktop — 配置文件路径：macOS ~/Library/Application Support/Claude/claude_desktop_config.json，Windows %APPDATA%\Claude\claude_desktop_config.json，使用 mcpServers 格式

相关链接

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

你有没有想过，写一篇文章、发一个 GitHub Repo，然后在你睡觉、上课、旅行的时候，账户里的佣金还在持续增长？

这不是幻想。在 Ace Data Cloud 的分销体系中，用户绑定是永久的——通过你的链接注册的用户，无论何时消费，你都能拿到佣金。这意味着，你今天写的一篇文章，可能在未来三年、五年内持续为你创造收入。

这篇文章，就来聊聊如何通过”内容沉淀”实现真正的 AI 分销被动收入。

一、为什么说内容沉淀是分销的最优解？

大多数人做分销的思路是”发朋友圈””群发消息”，这种方式有效，但本质上是一次性流量——你发一次，触达一次，然后就没了。

而内容沉淀完全不同：

• 一篇知乎文章，可能被搜索引擎收录，每天都有人通过搜索找到它
• 一个 GitHub 开源项目，可能被 star、fork，持续获得曝光
• 一篇 CSDN 技术教程，三年前写的，今天仍然有人在看

关键点在于：Ace Data Cloud 的用户绑定是永久的。 无论用户是今天注册还是两年后注册，只要是通过你的链接进来的，就永远是你的下线。他在 平台、Studio 三个端的所有消费，你都能拿到佣金。

二、佣金体系速览

在开始内容创作之前，先搞清楚你能赚多少：

举个例子：你写了一篇 DeepSeek API 评测文章，通过搜索引擎每月带来 20 个注册用户。假设每个用户月均消费 $30，那么：

• Level 1 阶段：20 人 × $30 × 10% = $60/月
• 累计用户增长后进入 Level 2：假设累计 100 个活跃用户 × $30 × 15% = $450/月
• 持续积累到 Level 3：200 个活跃用户 × $30 × 20% = $1,200/月

而这一切的起点，可能只是你花了一个下午写的一篇文章。

三、各平台内容策略

1. 知乎：长尾搜索的金矿

知乎的内容在百度搜索中权重极高，而且知乎文章的生命周期非常长。

推荐选题：

• “有哪些好用的 AI 绘画 API？”
• “DeepSeek API 和 OpenAI API 对比，哪个更划算？”
• “做 AI 创业有什么好的 API 平台推荐？”
• “Suno AI 音乐生成怎么接入自己的产品？”

写法要点：

• 先回答问题，展示真实使用体验
• 附上代码示例和效果截图
• 在文末自然地引导：”如果你也想试试，可以到 Ace Data Cloud 注册一个账号”（带上你的邀请链接）

一篇高质量的知乎回答可以持续获得流量 2-3 年，带来数百个注册用户。

2. CSDN / 掘金：技术教程的主战场

这两个平台的用户大多是开发者，是 API 产品的精准目标群体。

高转化选题：

• “5 分钟接入 Midjourney API，实现 AI 绘画功能”
• “用 Python 调用 Suno API 生成音乐完整教程”
• “OpenAI 兼容接口大全：一个 API Key 调用 GPT / Claude / Gemini”
• “AI 视频生成 API 横评：Sora vs Luma vs Veo”

内容模板：

1. 痛点引入（”调用 OpenAI 官方 API 经常超时？”）
2. 解决方案介绍
3. 代码实操（完整可运行的代码）
4. 效果展示
5. 注册/使用引导（带链接）

技术文章的优势是转化率高——看技术教程的人，大概率就是要用 API 的人。

3. GitHub：开源项目的长期资产

这是很多人忽略的渠道，但其实 GitHub 的分销效果非常好。

项目方向：

• 写一个调用 Ace Data Cloud API 的 SDK 或命令行工具
• 做一个 AI 应用的 demo 项目（比如 AI 壁纸生成器、AI 音乐工作站）
• 维护一个 “Awesome AI APIs” 的列表项目

在 README 中自然地引导用户注册时使用你的邀请链接。一个有 200+ stars 的项目，每周都能带来稳定的注册量。

4. YouTube / B站：视频内容的倍增效应

视频的信任度和转化率通常高于文字。制作一些教程视频：

• “3 分钟搭建你的 AI 聊天机器人”
• “用 API 生成 AI 视频的完整流程”
• “独立开发者必备的 10 个 AI API”

在视频描述中放置你的邀请链接，一个优质视频的长尾流量可以延续 1-2 年。

5. Medium / Dev.to：面向国际开发者

如果你英语还不错，海外技术社区的竞争反而更小：

• 写 “How to build an AI app using Ace Data Cloud APIs”
• 发布 “Best alternatives to OpenAI API for your project”

海外用户的客单价更高，一个活跃的海外用户可能月消费 $100+，按 10% 佣金就是 $10/月/人。

四、内容沉淀的复利效应

让我用一个真实案例来说明复利的威力：

假设你每月写 2 篇高质量文章，每篇每月带来 5 个注册用户：

关键是：哪怕你在第 6 个月停止写作，之前的文章仍然在持续带来新用户。 这就是沉淀的力量。

而平台上的头部推广者已经实现了：累计订单金额 ¥90 万+，佣金收入 ¥16.8 万+，邀请用户 3200+。

五、立即开始行动

1. 访问 分销控制台 获取你的专属邀请链接
2. 今天就选一个你熟悉的平台，写一篇文章
3. 不需要完美，先发出去，后续再优化

记住：你今天种下的每一篇内容，都是一颗未来持续产出收益的种子。

开始你的被动收入之旅 👉 https://platform.acedata.cloud

有任何问题，随时联系客服 👉 https://platform.acedata.cloud/support

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

Flux 是 Stable Diffusion 创始团队新做的模型，分三档：Dev（快，草稿级）、Pro（慢一点，精细）、Kontext（编辑已有图）。在 Claude Code 里加进去，随手出图特别方便。

获取 API Token

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

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

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

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

💡 如果你不想手动配置，也可以直接在 Claude.ai 网页版中使用，通过 OAuth 连接，无需 API Token。详见 Claude Desktop + Flux MCP 教程。

配置

1
2

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

⚠️ 注意： -H 必须大写。小写 -h 是 --help，不是 header 参数。

不加 -s 默认是 local scope，只在当前项目目录下生效。建议明确指定 scope：

三个模型三种用法

Dev —— 快速试方向

不确定要什么风格，先试几个：

1

> 用 flux-dev 快速生成 3 张不同风格的开发者博客封面图，分别试扁平、写实、抽象

几秒出一张，试错成本极低。

Pro —— 正式出图

看到喜欢的方向后：

1

> 用 flux-pro 重新生成第二张，提高细节和分辨率

Kontext —— 编辑现有图

设计师给了一张图，但日期需要改：

1

> 编辑这张海报图，把右下角的日期从 2024 改成 2025

flux_edit_image 做局部修改，不重新生成整张图。

工具

其他编辑器配置

• Cursor — .cursor/mcp.json，mcpServers 下同样配置
• VS Code — .vscode/mcp.json，servers 下同样配置
• Claude Desktop — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），mcpServers 下同样配置
• Windsurf — .windsurf/mcp.json，mcpServers 下同样配置

相关链接

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

本文将介绍 Veo Extend API 的对接说明。该接口用于对一段已经生成的 Veo 视频进行时长延展，AI 会自动续写后续画面。

申请流程

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

基本使用

调用本接口需要传入下列参数：

• video_id（必填）：来源视频的任务 ID（来自 /veo/videos 或本接口本身）。
• model（必填）：用于延展的模型，仅支持 veo31-fast 和 veo31 两个模型，其他模型上游不支持。
• prompt（选填）：用于引导延展段画面的文字提示。

请求示例：

1
2
3
4
5
6
7
8
9

curl -X POST 'https://api.acedata.cloud/veo/extend' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
    "model": "veo31-fast",
    "prompt": "the camera slowly zooms out to reveal more of the landscape"
  }'

返回结果与 /veo/videos 相同：

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

{
  "success": true,
  "task_id": "5fa2d9a6-7e54-481b-a4b0-3dc6f25dd2ab",
  "data": [
    {
      "id": "9b6f3b6b9c45419fbf2e3fe2f10b2b3a",
      "video_url": "https://platform.cdn.acedata.cloud/veo/5fa2d9a6.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

重要限制

来自 /veo/extend 的延展结果视频可以继续被 /veo/extend 再次延展，但是不能再被以下接口处理：

• /veo/reshoot —— 不能换镜头运动
• /veo/objects —— 不能再做物体增删

如果传入的 video_id 是延展结果，相关接口会返回 400 错误，请改用原始视频作为来源。

计费说明

• model=veo31-fast：1.20 Credit / 次
• model=veo31：7.64 Credit / 次

异步回调

接口支持异步模式，传入 callback_url 即可在任务完成后通过 POST 请求回调结果。

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

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

申请流程

要使用 Suno Tasks API，需要先到 申请页面 Suno Audios Generation API 申请相应的服务，然后复制 Suno Audios Generation API的任务ID，如图所示：

最后进入Tasks API页面 Suno Tasks API 申请相应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

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

首次申请时会有免费额度赠送，可以免费使用该 API。

请求示例

Suno Tasks API 可以用于查询 Suno Audios Generation API 和 Suno Lyrics Generation API 两个 API 的结果。关于怎样使用 Suno Audios Generation API，请参考文档 Suno Audios Generation API 。关于怎样使用 Suno Lyrics Generation API，请参考 Suno Lyrics Generation API 。

我们以 Suno Audios Generation API 服务返回的任务ID一个为例，演示如何使用该 API。假设我们有一个任务ID：eae26f89-b64b-404d-a80c-761996660b1c，接下来演示如何通过传入一个任务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/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "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/suno/tasks"

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

payload = {
    "id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "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
41
42
43
44
45
46

{
  "_id": "66d2add5550a4144a5a88dfe",
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
  "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
  "created_at": 1725083093.077,
  "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
  "request": {
    "action": "generate",
    "prompt": "A song for Christmas"
  },
  "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "data": [
      {
        "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e",
        "title": "Holiday Wishes",
        "image_url": "https://cdn2.suno.ai/image_b8a4f691-4b14-4120-a7e1-a54a27a0e57e.jpeg",
        "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
        "audio_url": "https://cdn1.suno.ai/b8a4f691-4b14-4120-a7e1-a54a27a0e57e.mp3",
        "video_url": "https://cdn1.suno.ai/b8a4f691-4b14-4120-a7e1-a54a27a0e57e.mp4",
        "created_at": "2024-08-31T05:44:54.806Z",
        "model": "chirp-v3.5",
        "prompt": "A song for Christmas",
        "style": "pop",
        "duration": 154.44
      },
      {
        "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e",
        "title": "Holiday Wishes",
        "image_url": "https://cdn2.suno.ai/image_1a3343b2-2c24-4584-a2a7-687e2f97f09e.jpeg",
        "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
        "audio_url": "https://cdn1.suno.ai/1a3343b2-2c24-4584-a2a7-687e2f97f09e.mp3",
        "video_url": "https://cdn1.suno.ai/1a3343b2-2c24-4584-a2a7-687e2f97f09e.mp4",
        "created_at": "2024-08-31T05:44:54.806Z",
        "model": "chirp-v3.5",
        "prompt": "A song for Christmas",
        "style": "pop",
        "duration": 147.16
      }
    ]
  }
}

返回结果一共有多个字段，request 字段就是发起任务时的 request body，同时response 字段是任务完成后返回的response body。字段介绍如下。

• 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/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"],
  "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/suno/tasks"

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

payload = {
    "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"],
    "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
86
87
88
89
90
91
92
93
94
95
96
97

{
  "items": [
    {
      "_id": "66d2add5550a4144a5a88dfe",
      "id": "eae26f89-b64b-404d-a80c-761996660b1c",
      "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
      "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
      "created_at": 1725083093.077,
      "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
      "request": {
        "action": "generate",
        "prompt": "A song for Christmas"
      },
      "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "eae26f89-b64b-404d-a80c-761996660b1c",
        "data": [
          {
            "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e",
            "title": "Holiday Wishes",
            "image_url": "https://cdn2.suno.ai/image_b8a4f691-4b14-4120-a7e1-a54a27a0e57e.jpeg",
            "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
            "audio_url": "https://cdn1.suno.ai/b8a4f691-4b14-4120-a7e1-a54a27a0e57e.mp3",
            "video_url": "https://cdn1.suno.ai/b8a4f691-4b14-4120-a7e1-a54a27a0e57e.mp4",
            "created_at": "2024-08-31T05:44:54.806Z",
            "model": "chirp-v3.5",
            "prompt": "A song for Christmas",
            "style": "pop",
            "duration": 154.44
          },
          {
            "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e",
            "title": "Holiday Wishes",
            "image_url": "https://cdn2.suno.ai/image_1a3343b2-2c24-4584-a2a7-687e2f97f09e.jpeg",
            "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
            "audio_url": "https://cdn1.suno.ai/1a3343b2-2c24-4584-a2a7-687e2f97f09e.mp3",
            "video_url": "https://cdn1.suno.ai/1a3343b2-2c24-4584-a2a7-687e2f97f09e.mp4",
            "created_at": "2024-08-31T05:44:54.806Z",
            "model": "chirp-v3.5",
            "prompt": "A song for Christmas",
            "style": "pop",
            "duration": 147.16
          }
        ]
      }
    },
    {
      "_id": "66d2b03c550a4144a5a8d93d",
      "id": "0d3ed03b-912b-4f7d-941b-8441323cb77b",
      "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
      "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
      "created_at": 1725083708.53,
      "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
      "request": {
        "action": "generate",
        "prompt": "la la la"
      },
      "trace_id": "29ebb919-1126-4156-86cc-4ad899432a8c",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "0d3ed03b-912b-4f7d-941b-8441323cb77b",
        "data": [
          {
            "id": "b4f498b2-e86f-4172-926a-39da9df84dd3",
            "title": "La La La",
            "image_url": "https://cdn2.suno.ai/image_b4f498b2-e86f-4172-926a-39da9df84dd3.jpeg",
            "lyric": "[Verse]\nMi vekiĝas ĉiumatene\nRigardas tra la fenestro\nSunbrilo brilanta hela\nKomenco de nova tago\n[Verse 2]\nLa birdoj kantas ĝoje\nMi dancas en la ĝardeno\nĈirkaŭas min floroj belaj\nĈiu momento ĉi estas mia\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon\n[Verse 3]\nLa maro blua kaj vasta\nOndoj tajdas dolĉe\nNi promenas sur plaĝoj\nSendepende de la tempo\n[Bridge]\nKaptu ĉiun horon\nAŭdu miajn kantadojn\nSentu vin libera\nFeliĉa\nDancu laŭ la ritmo nun\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon",
            "audio_url": "https://cdn1.suno.ai/b4f498b2-e86f-4172-926a-39da9df84dd3.mp3",
            "video_url": "https://cdn1.suno.ai/b4f498b2-e86f-4172-926a-39da9df84dd3.mp4",
            "created_at": "2024-08-31T05:55:09.345Z",
            "model": "chirp-v3.5",
            "prompt": "la la la",
            "style": "pop",
            "duration": 154.32
          },
          {
            "id": "8b44fdf1-3b88-47ac-a351-7c4b4de60549",
            "title": "La La La",
            "image_url": "https://cdn2.suno.ai/image_8b44fdf1-3b88-47ac-a351-7c4b4de60549.jpeg",
            "lyric": "[Verse]\nMi vekiĝas ĉiumatene\nRigardas tra la fenestro\nSunbrilo brilanta hela\nKomenco de nova tago\n[Verse 2]\nLa birdoj kantas ĝoje\nMi dancas en la ĝardeno\nĈirkaŭas min floroj belaj\nĈiu momento ĉi estas mia\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon\n[Verse 3]\nLa maro blua kaj vasta\nOndoj tajdas dolĉe\nNi promenas sur plaĝoj\nSendepende de la tempo\n[Bridge]\nKaptu ĉiun horon\nAŭdu miajn kantadojn\nSentu vin libera\nFeliĉa\nDancu laŭ la ritmo nun\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon",
            "audio_url": "https://cdn1.suno.ai/8b44fdf1-3b88-47ac-a351-7c4b4de60549.mp3",
            "video_url": "https://cdn1.suno.ai/8b44fdf1-3b88-47ac-a351-7c4b4de60549.mp4",
            "created_at": "2024-08-31T05:55:09.345Z",
            "model": "chirp-v3.5",
            "prompt": "la la la",
            "style": "pop",
            "duration": 177.36
          }
        ]
      }
    }
  ],
  "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"
}

结论

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

你让 Midjourney 画一张”春节快乐”的海报，结果文字写的是乱码。你让 DALL-E 画一张”水墨山水”，出来的东西像油画。

字节跳动做的 Seedream 专门解决这个问题——它真的懂中文。写”新年快乐”能让字生成得清晰可读，画”国潮”出来的真是那个味。

在 Cursor 里配好 MCP，做国内市场的项目时再也不用为中文素材发愁。

获取 API Token

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

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

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

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

配置

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

1
2
3
4
5
6
7
8
9
10
11

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

Seedream 的独特能力

中文文字渲染

这是 Seedream 最核心的优势——图片里的中文字是清楚的、正确的：

1

> 生成一张海报，大字写"2025 开发者大会"，副标题"AI 驱动未来"，蓝色科技风背景

换成 Midjourney 或 DALL-E 试试？中文字基本全乱。

国风美学

要做一个面向国内用户的 App，引导页想要点中国文化元素：

1

> 生成一张新中式风格的 App 引导页插画，远处是水墨山峦，近处是微光的数字河流，整体色调青绿

Seedream 训练数据里有大量中文互联网审美，这类风格是它的舒适区。

营销物料一气呵成

做电商项目，PM 要一张促销 Banner：

1

> 生成一张电商促销Banner，标题"限时3折"，背景是渐变橙红色，放一些购物袋和礼盒元素

中文字+商业设计感，Seedream 一张就够。

工具

其他编辑器配置

• VS Code — .vscode/mcp.json，servers 下同样配置
• Claude Code — 终端命令行配置，详见 Claude Code + Seedream MCP 教程
• Claude Desktop — 详见 Claude Desktop + Seedream MCP 教程
• Cline — .cline/mcp_settings.json，mcpServers 下同样配置

相关链接

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

你花了两周写完一个 CLI 工具，README 写得很详细。但你也知道——一段 30 秒的演示视频比 500 字的说明更有说服力。

录屏？太无聊。After Effects？太重了。其实 VS Code 里就能做。

在 Copilot Chat 里说：

1

> 生成一段视频：一个终端窗口中命令在执行，输出逐行出现，背景是深蓝色渐变，有微弱的粒子效果

Luma Dream Machine 会帮你生成一段质感很好的概念视频，可以直接放到产品页上。

获取 API Token

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

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

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

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

配置 VS Code

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

1
2
3
4
5
6
7
8
9
10
11

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

或安装 Ace Data Cloud MCP 扩展 一键配置。

保存后在 Copilot Chat 中切换到 Agent 模式，即可使用 Luma 视频生成能力。

实战场景

Landing Page 的 Hero 动画

你的 SaaS 产品首页需要一段吸引眼球的 Hero 视频。以前得找外包做动效，现在：

1

> 生成一段5秒循环的抽象视频，紫色和蓝色的流体在缓慢流动，科技感，适合做网页背景

luma_generate_video 出来的视频画面流畅、质感好，比很多收费素材网站的片段还强。

从设计稿生成产品动画

你有一张 Figma 导出的 App 截图，想让它”活”起来：

1

> 用这张手机截图作为参考，生成一段视频，让界面中的数据图表有一个从零增长到满的动画效果

luma_generate_video_with_reference 接受图片或视频作为参考，能把静态的 UI 变成有动效的演示。比自己写 CSS 动画录屏省时间多了。

视频续写

第一段视频效果不错但太短？不用重新生成：

1

> 把这段视频续写下去，镜头缓慢拉远，露出更大的全景

luma_extend_video 能基于已有内容接着生成，保持风格一致。

可用工具

其他编辑器配置

• Cursor — .cursor/mcp.json 中 mcpServers 下同样配置
• Claude Code — 终端命令行配置，详见 Claude Code + Luma MCP 教程
• Claude Desktop — 详见 Claude Desktop + Luma MCP 教程
• JetBrains — Settings → Tools → AI Assistant → MCP，添加 HTTP 类型的 Luma 服务

相关链接

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

Midjourney Tasks API 的主要功能是通过输入Midjourney Imagine API 或 Midjourney Describe API 生成的任务ID来查询该任务的执行情况。

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

申请流程

要使用 Midjourney Tasks API，需要先到 申请页面 Midjourney Imagine API 申请相应的服务，然后复制Imagine API的任务ID，如图所示：

最后进入Tasks API页面 Midjourney Tasks API 申请相应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

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

首次申请时会有免费额度赠送，可以免费使用该 API。

请求示例

MIdjourney Tasks API 可以用于查询 MIdjourney Imagine API 和 MIdjourney Describe API 两个 API 的结果。关于怎样使用 MIdjourney Imagine API，请参考文档 Midjourney Imagine API 。关于怎样使用 Midjourney Describe，请参考 Midjourney Describe API 。

我们以 Midjourney Imagine API 服务返回的任务ID一个为例，演示如何使用该 API。假设我们有一个任务ID：7489df4c-ef03-4de0-b598-e9a590793434，接下来演示如何通过传入一个任务ID来。

任务示例图

设置请求头和请求体

Request Headers 包括：

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

Request Body 包括：

• id：上传的任务ID。
• ids：批量查询时的任务 ID 数组。
• action：对任务的操作方式，支持 retrieve（单查）与 retrieve_batch（批量）。

设置如下图所示：

代码示例

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

部分代码示例如下：

CURL

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/midjourney/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "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/midjourney/tasks"

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

payload = {
    "id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "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
41
42
43

{
  "_id": "668aae3f550a4144a540803b",
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
  "created_at": 1720364607.967,
  "credential_id": "68253cc8-505d-47f4-97ad-0050a62e4975",
  "request": {
    "mode": "fast",
    "prompt": "A cat sitting on a table",
    "action": "generate"
  },
  "type": "imagine",
  "hold": false,
  "image_id": "1259525319472185344",
  "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
  "response": {
    "image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p",
    "image_width": 1024,
    "image_height": 1024,
    "actions": [
      "upscale1",
      "upscale2",
      "upscale3",
      "upscale4",
      "reroll",
      "variation1",
      "variation2",
      "variation3",
      "variation4"
    ],
    "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png",
    "raw_image_width": 2048,
    "raw_image_height": 2048,
    "progress": 100,
    "image_id": "1259525319472185344",
    "task_id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "success": true,
    "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
    "hold": false
  },
  "duration": 29.437000036239624,
  "finished_at": 1720364637.404
}