0%

产品推荐

Suno v6 已来:不需要为订阅买单,让每一次音乐生成都按实际需求计费

为了偶尔生成几首音乐,每个月都要先付一笔订阅费;项目没有调用,额度照样到期。

对内容团队和开发者而言,真正需要解决的问题,往往不是“能不能生成音乐”,而是能否以更低的启动成本,把音乐生成稳定地接入实际业务。

Ace Data Cloud 提供了另一种选择:没有固定订阅费,不使用就不产生调用费用;需要生成时,再按实际用量计费。

Suno v6,不只是一次音质升级

Suno 将 v6 定义为新一代音乐模型家族,包括 v6、v6-wild 和 v6-mini。其中,v6 强调可靠、准确和稳定的成品表现;v6-wild 更偏向探索性和变化感;v6-mini 则以更快、更高效的方式降低创作门槛。

产品推荐

一枚小小的发光硬币展开为巨大的高分辨率创作画布,象征 GPT Image 2 的低成本与 4K 能力

GPT Image 2:用很小的成本,打开更大的创作画布

如果一张 4K 图只要几分钱,你还会先出 1K,再花钱放大吗?

产品推荐

告别 WorkBuddy 图片生成短板:接入 GPT Image 2.5 完整教程

WorkBuddy 虽然有腾讯的图片生成模型,但是效果还是比不上 GPT Image 2.5 、Seedream、Nano Banana 2 等图片生成模型,所以,如果需要在工作中,无缝调用这些图片生成模型,那么你需要接入 Ace Data Cloud 提供的 MCP 服务即可。
本文将介绍如何接入 Ace Data Cloud 的 OpenAI MCP 服务,并调用 GPT Image 2.5,以及并通过实际案例测试其图片生成与编辑能力。

产品推荐

别再每天重复发文了:用 Ace Data Cloud 定时任务,把多平台运营安排起来

如果我需要管理非常多的平台发布,比如 掘金、CSDN ,以及海外的 X、Medium 的发布,甚至 Github 的回复反馈,Youtube 视频的创作和发布 这些都需要耗费大量的时间和人力。

产品推荐

【一键连万网】教你如何配置AceDataCloud的连接器功能,以及使用的方法案例

如果我想一键将文章发布到知乎、掘金、CSDN、微信公众号、小红书等中文平台。

技术教程

一步步拆解,使用AceData Studio发布文章到掘金的过程,AI自动化创作

现在市面上各个Agent项目层出不穷,虽然也有很多自动化的任务,但是要自动发布到一些平台的话,部分还是比较困难的。
AceData做到了,文章获取,改写文章以及发布到平台的功能,创建相应的skill,就可以创建自动任务,以方便完成平台文章的更新。
目前支持的平台有,掘金,微信公众号,CSDN等,海外的有X,Blogger等等。

技术教程

AceData Studio 连接知乎、CSDN、掘金、Medium、Hashnode、Blogger 和 X 的内容创作与发布示意图

不只写好一篇文章,还要把它发布出去

写一篇文章,真正耗时的往往不只是写作。准备资料、设计封面、转换排版、调整标题、登录不同网站、复制粘贴,再记录每个平台的发布结果,这些工作加在一起,才是完整的内容生产过程。

技术教程

用GPT-6 Astra构建皇室战争卡组:AI策略分析与巨人防守反击的4K横版封面

让 AI 推荐一套《皇室战争》卡组并不难。真正有价值的问题是:为什么选择这八张卡?它们如何互相配合?进攻和防守时应该怎样出牌?推荐结果又该如何验证?

技术杂谈

After the Alarm — Who stops the run? AI生成的安全告警主题概念插画,非事故现场还原。

2026年9月20日,上午10点02分11秒,OpenAI的一套监控系统发出了P0级告警。

技术教程

原创短片《最后一盏灯》的 AI 生成首帧:黄色小机器人站在夜色中的灯塔门旁

一座灯塔熄灭了。海面很安静,一个小机器人站在门口,抬头看了看黑下来的灯室。

技术教程

WeChat Bot × Claude Code 宣传海报:让微信消息自动变成工作流

微信不缺消息,缺的是消息之后的自动处理

不少团队每天都在微信里处理工作:客户问产品怎么配置,需要重新解释一遍;用户在群里反馈问题,需要复制到工单系统;服务出现异常,需要找到负责人并通知;一天聊了很多,最后还要手动整理问题和待办。

技术教程

Ace Data Cloud Studio 教程发布海报:从歌词到封面,让音乐拥有画面

一张好的专辑封面,不是把歌词里的名词堆进画面,而是让听众在看到它的第一秒,就感受到这首歌的处境与情绪。

产品推荐

Reddit Discussion Dataset 英文科技风海报:Ace Data Cloud 与 Reddit 标识,约 50 亿条帖子、300 亿条评论及 32–48 TB 压缩数据;实际版本与范围需确认。

一、为什么 AI 需要的不只是更多文本?

“这个方案不适合生产环境。”

技术教程

GPT-6 时代,重新思考 GEO:深蓝科技背景与多智能体数据光轨

GPT-6 带来的变化,不只是模型更聪明,而是我们可以更细地分配任务、控制推理投入、复用上下文。对于做内容和 GEO 的团队来说,真正值得研究的不是“哪个模型最强”,而是怎样让检索、写作、核验和发布这条流程更可靠,同时把每篇合格内容的成本降下来。

技术教程

Studio 首页展开图片创作分类,展示工具说明和创作入口

想做一个自己的 AI 网站,是不是得先买服务器、找人写代码,再研究怎么接模型?

技术教程

Suno AI 翻唱:上传音频、描述风格、试听动感流行改编成品

有一首现成的歌,想听听它换一种编曲会是什么感觉?不必从头写歌,现在AceData Studio可以非常方便的为你修改歌曲。

技术教程

📘 Overview:OpenCode MCP Overview →

你在远程服务器上用 OpenCode 排查一个 OOM 问题,看到一条不太熟悉的内核日志。以前只能复制错误信息、断开终端、切到本地浏览器搜索,再切回来。接上 Serp MCP Server 后,OpenCode 可以直接在终端里搜 Google,不需要离开命令行就能完成“看日志 → 搜资料 → 改代码”整条链路。

Google 搜索 MCP 适合在 OpenCode 里调试生产问题、做技术选型调研、查官方文档、找 GitHub issue,以及任何需要“搜索网页才能继续工作”的场景。

获取 API Token

使用 Google 搜索 MCP Server 之前,需要先准备一个 Ace Data Cloud API Token。OpenCode 和 Claude Code 共用一套 Token,获取流程一样:

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

获取 Ace Data Cloud API Key

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

想用 Claude Desktop / Claude.ai 网页版直接 OAuth 一键授权?请看 Google 搜索 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": {
"serp": {
"type": "remote",
"url": "https://serp.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 serp 也会回显 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": {
"serp": {
"type": "remote",
"url": "https://serp.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 "(占位符没解析)。

验证连接

配置后运行:

1
2
opencode mcp list
opencode mcp debug serp

看到 serp connected 即表示握手成功。失败时检查 ACEDATACLOUD_API_KEY 是否已导出、oauth 是否为 false,以及 Authorization 是否包含 Bearer 前缀。模型和工具 Schema 会持续变化,请从当前目录选择支持原生工具调用的模型。

典型场景

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

调试生产问题

1
搜索 nginx 502 bad gateway response header too large 怎么解决

技术选型调研

1
搜索一下 2025 年 Python 异步 ORM 的性能对比,SQLAlchemy 2.0 async vs Tortoise ORM

查官方文档

1
搜索 Kubernetes CronJob concurrencyPolicy 的官方文档,Forbid 和 Replace 的区别

工具列表

下表列出主要工具;可通过 curl -X POST https://serp.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"}' 获取当前完整清单:

工具 说明
serp_google_search Google 网页搜索,支持指定国家、语言、时间范围
serp_google_images Google 图片搜索
serp_google_news Google 新闻搜索
serp_google_videos Google 视频搜索
serp_google_maps / serp_google_places 地图 / 本地商户搜索

相关链接

技术教程

📘 总览指南:在 Claude 里用 Ace Data Cloud MCP →

通过 Suno MCP,Claude 可以根据描述或自定义歌词生成音乐,并查询、续写或改编已有任务。

什么是 MCP?

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

Ace Data Cloud 把 Suno 的核心能力封装成了一个远程 MCP Server,挂上去之后 Claude 就能直接:

  • 一句话生成完整歌曲(含人声 + 伴奏)
  • 自定义歌词、标题、风格、BPM
  • 从指定时间点续写已有歌曲
  • 翻唱、混搭、分离人声与伴奏
  • 生成歌词、管理声音风格 Persona

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

在 Claude.ai 网页版添加 Suno MCP

💡 Claude.ai 网页版接入是 OAuth 直连,不需要复制 API Token。你只需要一个能登录 Ace Data 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. 添加 Suno MCP Server

点击 Add custom connector,在弹出的对话框里填:

字段 值
Name Suno(随便取)
URL https://suno.mcp.acedata.cloud/mcp

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

3. OAuth 授权

第一次连接会跳到 Ace Data Cloud 的 OAuth 授权页:

用你的 Ace Data Cloud 账号登录、点 Authorize 即可。如果还没有账号,可在 Ace Data Cloud 完成注册。

4. 检查工具列表

授权完成后回到 Claude.ai,点开 Suno Connector,确认状态为 Connected。工具列表由 Server 动态提供;常用能力包括歌曲生成、歌词、续写、翻唱、Stem 分离、Persona 管理和任务查询。是否允许工具自动运行,请按任务敏感度和自己的权限偏好设置。

使用示例

Prompt: Generate a short upbeat summer song about sea breeze and ice cream.

Claude 会提交生成任务、查询任务状态,并在完成后返回歌曲信息和试听链接。下面是歌词结构示例:

1
2
3
4
5
[Chorus]
Sea breeze in my hair, ice cream on my lips
Summer's calling out with every salty kiss
Toes deep in the sand, sun kissing my skin
This perfect summer day, never let it end

🎧 关于试听链接:终态音频会优先使用 Ace Data Cloud CDN 地址;若持久化失败,结果可能保留原始媒体地址。需要长期使用时,请在任务完成后及时下载并保存。

更多玩法(同样一个 Connector)

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

自定义歌词写一首摇滚

1
2
3
4
Write a rock song called "Hurricane" with these lyrics:
[Verse] Charging through the storm, lightning tears the sky
[Chorus] We are the hurricane, no one can stop us now
Use heavy distorted guitars, driving drums, male vocals.

→ Claude 会调用自定义歌词版工具,把歌词原样送进 Suno。

续写一首歌

1
2
Extend this song from the 2-minute mark, add a bridge then a final chorus:
<song link or task id>

→ Claude 调用 extend_suno_song,保持原曲风格和声音。

翻唱 / 风格迁移

1
Take the song I just generated and cover it in lo-fi hip-hop style.

→ Claude 调用 cover_suno_song。

只要歌词不要曲

1
2
Just write me lyrics for a melancholic indie song about late-night trains.
No music yet.

→ Claude 调用 generate_suno_lyrics,纯文本返回。

常见问题

Q:为什么工具仍然要求确认?
A:Claude 会按工具和权限设置决定是否要求确认。请在 Connector 的当前工具列表中检查权限;涉及外部写入、发布或费用的操作,建议保留确认。

Q:余额不够怎么办?
A:错误信息里会带 insufficient balance。请到 Ace Data Cloud 控制台 查看并补充额度。

Q:可以同时挂多个 MCP 吗?
A:可以。Claude.ai 支持多 Connector 并存,比如同时挂 Suno + Flux + Veo,一句 “Write me a song about a cyberpunk city, then make a music video for it” 就能让 Claude 自己编排音乐生成 + 视觉生成的流水线。完整列表见 Claude MCP 总览。

Q:Claude Desktop 也能这么用吗?
A:能。Desktop 同样支持远程 MCP,配置流程几乎一模一样,详见 Claude Desktop + Suno MCP。如果你更习惯命令行,参考 Claude Code + Suno MCP。

相关链接

API 开发教程

Ace Data Cloud X402 当前围绕 USDC 结算,支持 EVM 和 Solana 两类链。不同网络的签名方式、资产地址、gas 行为和适用场景不同,接入前需要先选好网络。

网络标识使用 CAIP-2

x402 v2 的 accepts[].network 是 CAIP-2 标识,不是 base、skale 这类简称。客户端匹配网络时必须按 CAIP-2 字符串比较:

网络 CAIP-2 标识
Base eip155:8453
SKALE Base eip155:1187947933
Solana mainnet solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp

支持矩阵

网络 scheme 资产 签名方式 适用场景
Base exact Base USDC EIP-3009 TransferWithAuthorization 默认推荐,钱包和流动性支持成熟。
Base upto Base USDC + Permit2 Permit2 PermitWitnessTransferFrom 聊天、模型等后置计量 API。
SKALE exact SKALE bridged USDC EIP-3009 TransferWithAuthorization 低 gas 成本,适合 EVM 支付验证和低成本调用。
Solana exact Solana USDC SPL TransferChecked Solana 钱包、Agent 或链上应用场景。

upto 目前只在 Base 上提供。实际可用项以 API 返回的 accepts 为准。你也可以查看 Facilitator:

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

Facilitator /supported 的返回:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"kinds": [
{ "x402Version": 2, "scheme": "exact", "network": "eip155:8453" },
{
"x402Version": 2,
"scheme": "upto",
"network": "eip155:8453",
"extra": { "facilitatorAddress": "0xd019238EAA8a9Ca13C5792Ca10B4029D6ce25708" }
},
{ "x402Version": 2, "scheme": "exact", "network": "eip155:1187947933" },
{
"x402Version": 2,
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"extra": { "feePayer": "3SPm6qbgsDkj24MuR8Ss4sH97fziqyCiqFKDyeVU2igq" }
}
]
}

结果说明:

  • Base、SKALE 和 Solana 的 exact 是固定金额支付路径。
  • 只有 Base 提供 upto 后置计量路径,依赖 Permit2 approve。
  • upto 条目里的 extra.facilitatorAddress 是客户端签名时要写入 witness 的地址,必须和服务端返回值一致。

Base

Base 使用官方 USDC 合约:

1
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

exact 方案中,客户端签署 EIP-712 TransferWithAuthorization。签名内容包括:

  • from:付款钱包地址
  • to:Ace Data Cloud 收款地址
  • value:本次支付金额
  • validAfter / validBefore:签名有效时间窗口
  • nonce:32 字节随机 nonce

Facilitator 验证签名后,会在链上调用 USDC 的 transferWithAuthorization 完成转账。

Base 是最推荐的正式接入网络,尤其适合 upto 后置计量,因为 Permit2、USDC 和钱包生态都更成熟。

Base exact 验证结果示例:

1
2
3
4
5
6
payer 0x5d4f08D5c2bb60703284bc06671Eb680fA41B105
content ADC_BASE_E2E_OK
tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3
block 46726299
explorer https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3
transfer value 95215 atomic USDC

结果说明:

  • API paid retry 返回模型内容 ADC_BASE_E2E_OK。
  • 链上交易已在 BaseScan 可查,区块号是 46726299。
  • 95215 atomic USDC 对应 0.095215 USDC,是这次 API 调用的实际结算金额。

订单支付 Base exact 的程序运行结果:

1
2
3
4
5
6
order 78481793-304e-47f7-bc0c-8231aec9cc1e
state Finished
tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151
block 46726704
explorer https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151
transfer value 1200000 atomic USDC

结果说明:

  • 平台订单最终状态是 Finished。
  • 订单 pay_id 写入同一个 Base 交易哈希。
  • 1200000 atomic USDC 对应 1.2 USDC,是 10 Credits 订单应用 X402 折扣后的实付金额。

SKALE

SKALE 使用 bridged USDC,签名方式与 Base 类似,也是 EIP-3009。它适合低 gas 成本的 EVM 支付场景;实际调用仍以 API 返回的 accepts 为准。

SKALE 的典型 402 accepts 中会包含:

1
2
3
4
5
6
7
8
9
10
{
"network": "eip155:1187947933",
"scheme": "exact",
"extra": {
"name": "Bridged USDC (SKALE Bridge)",
"version": "2",
"chainId": 1187947933,
"verifyingContract": "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
}
}

SKALE 当前只提供 exact。如果你需要后置计量,请使用 Base upto。

SKALE exact 验证结果示例:

1
2
3
4
5
content ADC_SKALE_E2E_OK
tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f
block 1969317
explorer https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f
paid 0.095215 USDC

结果说明:

  • API paid retry 返回模型内容 ADC_SKALE_E2E_OK。
  • 交易已在 SKALE explorer 可查,区块号是 1969317。
  • 这次 exact 支付的结算金额是 0.095215 USDC。

Solana

Solana 使用 SPL USDC TransferChecked。客户端会构造一笔转账交易,签名并提交,之后把交易签名或序列化交易放入 PAYMENT-SIGNATURE envelope。

Solana 的特点:

  • 使用 Solana wallet adapter 或 base58 secret key;
  • 资产是 Solana USDC mint;
  • 当前只支持 exact;
  • Facilitator 会校验 transfer instruction 的 mint、destination、authority 和 amount。

如果使用钱包 fee payer 模式,钱包会直接提交交易,Facilitator 负责确认交易并返回 settlement 结果。

Solana exact 验证结果示例:

1
2
3
4
payer AY2RmGm2zPxB1uKvvF4dKyYdr2VySyL3wcD1MKJZoLRd
HTTP 402 -> HTTP 200
content ADC_SOLANA_E2E_OK
chain signature not confirmed in this run

结果说明:

  • paid retry 已经返回 HTTP 200,并且模型输出 ADC_SOLANA_E2E_OK。
  • 公开 RPC 查询链上 signature 时可能遇到限流。
  • 因为公开 RPC 查询可能限流,这里不写 Solana explorer。需要严格对账时,请使用自有 Solana RPC 或平台侧结算记录确认交易签名。

如何选择

你要做什么 推荐网络
快速跑通最小链路 SKALE exact 或 Base exact
面向普通 Web3 用户 Base
做聊天补全等后置计量 Base upto
Solana 生态应用 Solana exact
低成本 EVM 支付验证 SKALE exact

无论选择哪条链,都不要在客户端硬编码价格。价格由服务器返回的 accepts[].maxAmountRequired 决定。

技术教程

你刚用 Figma 出了一版 App 的新界面设计,发到群里征求意见。产品经理回了一句:”能不能看看动态效果?”自己写代码实现一遍太费时间,但你有一张 PNG 截图就够了——交给 Seedance MCP Server,它能把静态图变成一段带动效的视频。字节跳动的模型,对中文场景尤其友好。

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

  1. 打开 VS Code 扩展市场(Cmd+Shift+X)
  2. 搜索 Seedance MCP,或直接搜索扩展 ID:acedatacloud.mcp-seedance
  3. 点击 Install,安装后按提示重载窗口

第 2 步:获取并填写 API Key

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

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

第 3 步:验证已连通

  1. 打开 GitHub Copilot Chat,切到 Agent 模式
  2. 直接提需求并点名 seedance,例如:用 seedance 帮我完成这个任务
  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": {
"seedance": {
"type": "http",
"url": "https://seedance.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
}
]
}

第 3 步:验证已连通

  1. 打开 GitHub Copilot Chat,切到 Agent 模式
  2. 直接提需求并点名 seedance,例如:用 seedance 帮我完成这个任务
  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": {
"seedance": {
"type": "http",
"url": "https://seedance.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer ${input:acedata-token}"
}
}
},
"inputs": [
{
"id": "acedata-token",
"type": "promptString",
"description": "Ace Data Cloud API key",
"password": true
}
]
}

第 3 步:验证已连通

  1. 打开 GitHub Copilot Chat,切到 Agent 模式
  2. 直接提需求并点名 seedance,例如:用 seedance 帮我完成这个任务
  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": {
"seedance": {
"type": "http",
"url": "https://seedance.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer ${input:acedata-token}"
}
}
},
"inputs": [
{
"id": "acedata-token",
"type": "promptString",
"description": "Ace Data Cloud API key",
"password": true
}
]
}

实际用法

产品原型的动效预览

把 Figma 设计稿导出成图片,让 Seedance 自动生成带交互动效的预览视频:

1
> 用这张 Dashboard 截图生成一段视频,数据图表从左到右依次出现,有淡入和数值增长的动画

给产品经理看一眼就能确认方向,省去手动实现动效的时间。

给内部工具录一段演示

你做了一个内部用的运维面板,要在周会上演示但来不及录屏:

1
> 生成一段视频:一个运维监控大屏上的仪表盘在实时刷新,曲线在波动,数字在跳动,深色主题

纯文字描述就能出效果,适合快速产出演示素材。

短视频素材

你运营着一个技术类的抖音账号,需要片头动画:

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

每期换个主题,Seedance 几分钟就能出一版。

工具

工具 说明
seedance_generate_video 文本/图片生成视频

其他编辑器配置

相关链接

API 开发教程

本文将介绍一种 身份信息及有效期核验 API 对接说明,它可用于校验姓名、身份证号、身份证有效期的真实性和一致性。

申请流程

要使用 身份信息及有效期核验 API,首先到 Ace Data Cloud 控制台 获取您的 API Token,留作备用。

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

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

📘 完整文档:身份信息及有效期核验 API →

基本使用

首先先了解下基本的使用方式,就是输入身份证图片链接,便可获得处理后验证结果,首先需要简单地传递一个 name 字段,我们接下来就可以在界面上填写对应的内容,如图所示:

可以看到这里我们设置了 Request Headers,包括:

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

另外设置了 Request Body,包括:

  • name:姓名。
  • id_card:身份证号。
  • image_url:需要处理的人脸图片链接。
  • validity_end:身份证有效期到期时间,格式:YYYYMMDD,长期用“00000000”代替;
  • validity_begin:身份证有效期开始时间,格式:YYYYMMDD。
  • encryption:可选,敏感字段加密参数(如需上送密文)。

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

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

1
2
3
4
{
"result": "0",
"description": "一致"
}

返回结果一共有多个字段,介绍如下:

  • result,认证结果码,收费情况如下。
    • 收费结果码:
      • 0: 姓名和身份证号一致
      • -1: 姓名和身份证号不一致
    • 不收费结果码:
      • -2: 非法身份证号(长度、校验位等不正确)
      • -3: 非法姓名(长度、格式等不正确)
      • -4: 证件库服务异常
      • -5: 证件库中无此身份证记录
      • -6: 权威比对系统升级中,请稍后再试
      • -7: 认证次数超过当日限制。
  • description,此处姓名与身份证号码验证的结果。

可以看出身份证中姓名、身份证号、身份证有效期具有真实性和一致性。

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

1
2
3
4
5
6
7
8
9
10
curl -X POST 'https://api.acedata.cloud/identity/idcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"name": "***",
"id_card": "***",
"validity_begin": "***",
"validity_end": "***"
}'

Python 的对接代码如下:

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

url = "https://api.acedata.cloud/identity/idcard/check-2e"

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

payload = {
"name": "***",
"id_card": "***",
"validity_begin": "***",
"validity_end": "***"
}

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

错误处理

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

结论

通过本文档,您已经了解了如何使用 身份信息及有效期核验 API 进行校验姓名、身份证号、身份证有效期的真实性和一致性。希望本文档能帮助您更好地对接和使用该 API。如有任何问题,请随时联系我们的技术支持团队。

产品推广

Seedance 是字节 Doubao 系的视频生成模型。它在国内内容场景里很实用:中文提示词理解好、图生视频稳、还支持传真人照片做”角色参考”,让同一个人出现在全新场景里。

这篇讲怎么用 Ace Data Cloud 上的 Seedance API。接口是 POST https://api.acedata.cloud/seedance/videos,文档在 platform.acedata.cloud/documents/seedance-videos。到控制台拿一个 Token 就能调用,首次申请带免费额度。

先看真实成片和真实成本

下面这段是用 Seedance 跑出来的一段电影感短片(纸船在水面漂流的镜头)。这次调用平台记录的真实成本是 5.7 credits——不是估算,是这条请求实际扣的量。

📹 https://cdn.acedata.cloud/de34c29169.mp4

基本用法:文生视频

Seedance 的输入结构和别的视频接口略有不同——提示词、参考图、参考音视频都放在一个 content 数组里,每一项用 type 区分。最简单的文生视频只放一个 type: text:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl -X POST 'https://api.acedata.cloud/seedance/videos' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"model": "doubao-seedance-2-0-fast-260128",
"content": [
{"type": "text", "text": "A white paper boat drifts on a calm dark water surface at dusk, cinematic reflection, gentle ripples, slow dolly-in, moody lighting."}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"async": true
}'

视频生成要 1–2 分钟,加 "async": true 立即拿到 task_id:

1
2
3
4
5
{
"success": true,
"task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
"trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4"
}

然后向 /seedance/tasks 轮询,任务完成时 data.status 为 succeeded、data.video_url 就是成品:

1
2
3
4
curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{"id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39", "action": "retrieve"}'
1
2
3
4
5
6
7
8
9
10
{
"success": true,
"task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
"data": {
"task_id": "cgt-20251222072003-x2259",
"status": "succeeded",
"video_url": "https://platform2.cdn.acedata.cloud/seedance/....mp4",
"model": "doubao-seedance-2-0-fast-260128"
}
}

图生视频:首帧 / 首尾帧

想让一张图动起来,在 content 里加 type: image_url 的项。注意 image_url 必须是对象格式 {"url": "https://..."},不能直接传字符串,否则会 400。

只传一张 → 首帧模式,视频从这张图开始运动。传两张并分别标 role: first_frame 和 role: last_frame → 首尾帧模式,视频从第一张过渡到第二张:

1
2
3
4
5
6
7
8
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "360-degree shot"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://.../first.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://.../last.jpg"}}
]
}

全模态参考与视频编辑(Seedance 2.0 / 2.5)

Seedance 2.0 系列可组合角色、音频与视频参考;Seedance 2.5(doubao-seedance-2-5-260628)进一步支持最多 30 张参考图、10 段视频、10 段音频、纯音频参考,以及对参考视频进行编辑或延长。

1
2
3
4
5
6
7
8
9
10
{
"model": "doubao-seedance-2-0-fast-260128",
"content": [
{"type": "text", "text": "The same woman wearing a beige coat walks through a sunny autumn park, golden leaves falling around her, she smiles softly at the camera, cinematic tracking shot."},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://.../portrait.jpg"}}
],
"resolution": "720p",
"ratio": "9:16",
"duration": 5
}

几个要点:

  • 首帧、首尾帧和全模态参考三种场景互斥:first_frame / last_frame 不能与 reference_image / reference_video / reference_audio 混用;
  • 2.5 的 omni_reference_task_type 可设为 auto、reference、edit 或 extend;
  • 请仅上传自有或已获授权的真人、角色与音视频素材。

如果你想让人物精确复刻照片里的构图(而不是”换个场景的同一个人”),改用 first_frame 让视频从这张照片开始运动即可。

常用参数速查

  • model:1.x、1.5、2.0 与 doubao-seedance-2-5-260628;
  • resolution:480p / 720p / 1080p,2.0 Standard 另支持 4k;
  • ratio:16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive;
  • duration:2.0 为 4–15 秒,2.5 为 4–30 秒,均支持 -1 自动时长;
  • generate_audio:1.5 Pro 与 2.x 支持生成带声音的视频;
  • callback_url:异步回调地址,任务完成时平台把结果 POST 过去(也可以用 async + 轮询)。

用它做点什么

  • 竖屏短视频:ratio: 9:16 直接出适配抖音/小红书的竖版,配合 2.0 的真人参考,可以让固定出镜人设批量出内容;
  • 电商与产品:用首帧模式让产品图旋转/展示,或首尾帧模式做”形态变化”演示;
  • 有声短片:用 doubao-seedance-1-5-pro-251215 + generate_audio 一步出带环境音的片子。

这些用法里,”稳定出镜的真人短视频”尤其值钱——它是内容账号最难持续供给的一环。把你用的工具链接放进主页,通过 Ace Data Cloud 创收联盟让通过你注册的用户消费产生返佣,是内容之外的一条收入;或者把这套异步生成流程包成工具,卖给需要批量做短视频的商家,成本就是平台按量计费的部分(比如上面那条 5.7 credits)。

参考链接

先用免费额度跑一条文生视频,再试试真人参考,你会对它能做什么有更具体的判断。

技术教程

定时自动发布

Studio 定时任务可以按计划尝试生成内容并调用已授权的 Skill。它适合把已经手动跑通的流程定期执行,但不是“设置一次就永远成功”的发布保证。

任务结果取决于模型、余额、连接状态、凭证有效期、Skill 权限、目标平台可用性、审核与风控。先保存草稿、定期看运行历史,并保留人工复核和停用机制。

一、入口与任务组成

进入 Studio 定时任务,新建任务并配置:

  • 名称和执行计划;
  • 固定模型与提示词;
  • 允许使用的 Skill 和 MCP;
  • 无人值守允许列表;
  • 启用状态与运行历史。

定时任务列表

二、为什么要配置允许列表

定时任务运行时没有人在场逐次确认,因此默认不会加载所有外部能力。需要显式允许本次任务使用的 Skill 和 MCP:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"name": "每周技术内容草稿",
"schedule": {
"type": "cron",
"value": "0 9 * * 1"
},
"template": {
"model": "gpt-5.5",
"question": "根据本周已核实的产品更新生成一篇技术草稿",
"skills": ["juejin"],
"mcp_servers": ["openai"]
},
"unattended_policy": {
"allowed_skills": ["juejin"],
"allowed_mcp_servers": ["openai"]
}
}

如果运行历史出现 skill_not_active,核对 Skill 是否已连接并加入 allowed_skills;配图能力同样需要加入允许的 MCP 列表。

定时任务编辑

三、先手动验证,再设置计划

  1. 按Connector 总览连接目标平台;
  2. 在普通对话中手动执行同一提示词;
  3. 核对事实、链接、图片、格式和平台规则;
  4. 优先确认能成功保存草稿;
  5. 再创建低频定时任务,并先“立即运行一次”;
  6. 在运行历史中检查终态和目标平台实际结果。

不要只依据任务显示“完成”就假定内容已经公开。部分 Skill 只保存草稿,部分平台还会要求确认、验证码或审核。

四、一个保守的技术内容示例

提示词可以从生成草稿开始:

1
2
3
4
5
6
7
8
根据本周已经核实的 AI 产品更新,选择一个适合开发者的话题:

1. 只引用能够核实的公开信息;
2. 写一篇 800–1200 字的技术草稿,包含一个可复现的小例子;
3. 生成一张不含品牌误导和虚假文字的封面;
4. 文末保留我的邀请链接占位;
5. 保存到目标平台草稿箱,不直接公开;
6. 返回草稿标题、链接和需要我复核的事实。

先用每周一次的频率观察质量和稳定性。人工复核稳定后,再根据平台能力决定是否允许直接发布。

五、定期检查

每次运行后

  • 是否真实生成了草稿或公开内容;
  • 是否存在事实、代码、链接或图片错误;
  • 是否触发审核、限流或账号提示;
  • 是否产生了预期内的额度消耗。

每周

  • 检查凭证和账号状态;
  • 查看失败原因并修正提示词;
  • 删除重复、低质量或过时任务;
  • 确认发布频率符合目标平台规则。

连续失败、内容质量下降或账号出现风险提示时,应立即停用任务,不要自动重试刷屏。

六、哪些场景不适合无人值守

  • 需要本地浏览器在线、验证码或现场确认的平台;
  • 涉及新闻、价格、政策或其他易变化事实的内容;
  • 使用客户数据、未公开信息或受版权保护素材;
  • 高频跨平台复制同一内容;
  • 未经过一次完整人工验证的新 Skill。

小红书等本地浏览器流程更适合人在电脑前触发。具体限制查看对应渠道教程。

下一步

API 开发教程

如果你想自定义生成歌曲,但又不太想自己编写歌词,可以使用 AceDataCloud 提供的歌词生成 API 来通过 prompt 生成歌词,API 是 Suno Lyrics Generation API。

该 API 主要输入参数是 prompt,可选 model(可选值 default、remi-v1,默认 default),填写样例如下:

这里我们输入的 prompt 是 A song about winter,生成和冬天相关的歌曲。

点击运行,结果如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"success": true,
"task_id": "2e26f7ff-0b82-4a60-bb9b-78db89f98b51",
"data": [
{
"text": "[Verse]\nSnowflakes falling from the sky\nWinter's cold touch\nOh how it gets me high\nI bundle up in layers\nOh so cozy\nStepping out and feeling the frost on my nose\n\n[Chorus]\nOh\nWinter's cold touch\nIt's a season that I love so much\nSnowfall brings a feeling so divine\nWinter's cold touch\nIt's a magical time",
"title": "Winter's Cold Touch",
"status": "complete",
"tags": ["dreamy, mellow, ballad"]
},
{
"text": "[Verse]\nThe world is covered in a blanket of white\nIcicles hanging\nShimmering so bright\nThe chilly air fills my lungs with every breath\nWalking in the snow\nLeaving footprints behind\n\n[Chorus]\nWinter wonderland\nEverything is so bright\nWinter wonderland\nHold me through the night",
"title": "Winter Wonderland",
"status": "complete",
"tags": ["dream pop, mellow, shoegaze"]
}
],
"started_at": 1780684179.15,
"finished_at": 1780684186.583,
"elapsed": 7.433
}

可以看到,data 是一个数组,每次会返回多个歌词候选,其中每个元素的 text 字段就是歌词内容,title 是标题,tags 是推荐的曲风标签。

有了歌词之后,我们便可以使用 Suno Audios Generation API 来进行自定义歌曲生成了。

技术教程

一篇好文持续带搜索和推荐流量好几个月

Medium 是英文世界最主流的「深度长文」平台之一——读者愿意读、内容有长尾,一篇好的 Medium 文章能持续带来搜索和推荐流量。推广 API Platform、经营英文白牌站或把 API 集成到自有产品的,Medium 值得认真经营。

这一篇教你连上 Medium,让 AI 以你的身份写英文深度文、传图、发布,再看数据。


这个连接器能干什么(如实说)

  • 授权方式:按连接页提示使用 ACE 扩展授权你已登录的 Medium 会话。授权可能过期,需在连接管理页重新连接。
  • 能读:列出你的文章,带 clap / response / 阅读时长 统计;也能看单篇。
  • 能发:发布一篇新 Story,正文是 Markdown(自动转成 Medium 格式);支持配图——图片会上传到 Medium 并嵌入正文(image-delta),所以示意图、截图、效果图都能带。
  • 发布是你真实账号的写操作,发文前会让你确认。

手把手:连接 → 让 AI 发 → 看数据

1. 连接你的 Medium 账号

打开 https://studio.acedata.cloud/console/connectors,找到 medium,用 ACE 扩展在 medium.com 登录态下捕获一次 Cookie,状态变 Active。

Medium 连接器详情:登录 Cookie 授权,状态 Active,支持发布 Story 并上传配图

2. 让 AI 写英文深度文 + 配图 + 发布

到 Studio 里说:

「Write a Medium story: “How I built an AI headshot generator in an afternoon with one API”,结构清晰、有代码有配图、地道英文,末尾自然带上我的邀请链接,配一张架构图,然后发到 Medium(先给我确认)。」

配图让 AI 用 gpt-image-2 生成:POST https://api.acedata.cloud/openai/images/generations,body {"model":"gpt-image-2","prompt":"...","size":"1536x1024"},鉴权用平台 API Key,交给 Medium 连接器会自动上传嵌入。

3. 回头看数据

让 AI「列一下我 Medium 文章的 claps、responses、阅读时长」,把跑得动的选题继续做。


别忘了埋你的分销链接(这才是收益来源)

在内容中自然放置你从分销后台复制的专属邀请链接。邀请归属、等级、比例、确认期和提现条件统一见推广方式与佣金规则;只有符合当前规则的有效订单才可能产生佣金。


内容建议(Medium 吃哪一套)

  • 标题实用、可搜索:「How to…」「Building…」「X vs Y」在 Medium 和搜索引擎上都吃得开。
  • 结构清晰:小标题、代码块、配图分段。读者读长文,但要「好读的长文」。
  • 讲一个完整故事/教程:从问题到解决到结果,读者跟着走一遍,末尾「想自己试试」的链接就顺理成章。
  • 地道英文 + 配图:架构图、结果截图、对比图都提升完读率。

如实提醒

  • 发布受 Medium 账号权限、审核和授权有效期影响;失败时回到连接管理页检查并重新授权。
  • Medium 重质量和原创,低质搬运触达很差;别通篇软广,价值在前、链接在后。
  • 发布前确认内容和排版,善用这一步。

把它自动化

手动跑通后,可参考定时任务内容工作流按计划尝试生成草稿或调用发布 Skill。执行受账号、授权、余额、审核和目标平台政策影响,需要持续检查运行历史。


Medium 的一篇好文能被搜索和推荐持续带流量好几个月。用它建立你在英文世界的专业形象,把感兴趣的读者引导到你的服务,再根据后台数据评估效果。

API 开发教程

「申请(Application)」表示当前账户对某个服务的订阅关系——必须先申请,才能再为这个申请创建 API 凭证、调用业务接口。首次申请一个服务会自动获得该服务设定的免费额度(如 1 Credit),可立即试用。

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

完整的对接流程

新用户从注册到调通第一个业务接口,通常走这 5 步:

  1. 拿到账户令牌 → 管理 AceDataCloud 平台账户令牌
  2. 挑选服务 → 获取 AceDataCloud 平台服务列表
  3. 创建申请(本文档) → 自动获得免费额度
  4. 创建 API 凭证 → 创建 AceDataCloud 平台 API 凭证
  5. 调用业务接口 → 用得到的 32 位 Token 调 https://api.acedata.cloud/<path>

接口概览

项 内容
方法 POST
URL https://platform.acedata.cloud/api/v1/applications/
鉴权 ✅ 需要账户令牌
Content-Type application/json

鉴权说明(如何获取账户令牌)

请求头:

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

账户令牌(Account Token)是开发者通过 API 管理自己账户资源的”账号级密钥”。获取方式:

  1. 控制台一键创建(推荐):登录 AceDataCloud 平台 → Account Token 控制台 → 点「创建」即可获得 platform-v1- 开头的令牌。
  2. API 创建:用已有的账户令牌或浏览器登录态 JWT 调用 POST /api/v1/platform-tokens/,详见管理 AceDataCloud 平台账户令牌。

⚠️ 账户令牌与密码同等敏感,禁止写入前端代码或公开仓库。一旦泄露立即在控制台删除并重建。

请求体

参数 类型 必填 说明
service_id UUID ✅ 要申请的服务 ID。可从服务列表的 items[].id 获取

请求示例

cURL

1
2
3
4
5
curl -X POST 'https://platform.acedata.cloud/api/v1/applications/' \
-H 'accept: application/json' \
-H 'authorization: Bearer platform-v1-92eb****629c' \
-H 'content-type: application/json' \
-d '{"service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452"}'

Python

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

PLATFORM_TOKEN = "platform-v1-92eb****629c"
SERVICE_ID = "38ecf158-36f2-42f2-8e7f-6786cdfc2452"

resp = requests.post(
"https://platform.acedata.cloud/api/v1/applications/",
headers={
"accept": "application/json",
"authorization": f"Bearer {PLATFORM_TOKEN}",
"content-type": "application/json",
},
json={"service_id": SERVICE_ID},
timeout=10,
)

if resp.status_code == 201:
app = resp.json()
print(f"申请成功!application_id={app['id']}")
print(f"赠送免费额度:{app['remaining_amount']} {app.get('unit', '')}")
elif resp.status_code == 400 and resp.json().get("code") == "duplication":
print("⚠️ 已经申请过此服务,请到 /applications/ 列表里找到现成的 application_id")
else:
print(f"申请失败:HTTP {resp.status_code} - {resp.text}")

Node.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
const PLATFORM_TOKEN = 'platform-v1-92eb****629c'
const SERVICE_ID = '38ecf158-36f2-42f2-8e7f-6786cdfc2452'

const resp = await fetch('https://platform.acedata.cloud/api/v1/applications/', {
method: 'POST',
headers: {
accept: 'application/json',
authorization: `Bearer ${PLATFORM_TOKEN}`,
'content-type': 'application/json',
},
body: JSON.stringify({ service_id: SERVICE_ID }),
})

if (resp.status === 201) {
const app = await resp.json()
console.log('application_id =', app.id)
} else {
console.error(await resp.text())
}

响应示例

成功(HTTP 201)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"id": "82f57141-2323-4453-8730-60f7d833a2da",
"service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
"remaining_amount": 1.0,
"used_amount": 0.0,
"paid": false,
"user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
"disabled": false,
"allow_consume_global": false,
"scope": "Individual",
"type": "Usage",
"expired_at": null,
"tags": null,
"metadata": null,
"client_ip": null,
"client_fingerprint": null,
"created_at": "2026-04-26T07:52:27.462400Z",
"updated_at": "2026-04-26T07:52:27.462400Z"
}

返回字段结构与获取 AceDataCloud 平台服务申请详情一致。

已申请过(HTTP 400)

1
2
3
4
5
{
"detail": "Item already exists.",
"code": "duplication",
"trace_id": "1a87524f8cbba0b790b2951e2e43117e"
}

这是设计上的硬限制:每个用户对每个服务只能有一个 Application。已存在时通过获取 AceDataCloud 平台服务申请列表查找现成的。

服务不存在(HTTP 404)

1
2
3
4
5
{
"detail": "Service not found.",
"code": "not_found",
"trace_id": "..."
}

服务需要审核(HTTP 403)

1
2
3
4
5
{
"detail": "This service requires manual verification.",
"code": "need_verify",
"trace_id": "..."
}

如果服务的 need_verify=true(在服务列表里可看到该字段),需走工单流程申请白名单。

错误处理

HTTP code 含义
400 duplication 该服务已被当前账户申请过
400 invalid service_id 缺失或格式错误
401 not_authenticated 缺少账户令牌或令牌已被删除
403 need_verify 服务需要审核,请走工单流程
404 not_found 服务不存在或已下线

错误响应统一格式:

1
2
3
4
5
{
"detail": "...",
"code": "...",
"trace_id": "..."
}

实用提示

  • 申请是免费操作:仅在创建 Application 时赠送一次性免费额度,不会扣余额。免费额度用完后调用业务接口才会失败,提示需要充值。
  • 是否需要付费看 paid 字段:刚申请时 paid=false,调用创建 AceDataCloud 平台充值订单 完成支付后变为 true。
  • disabled=true 表示被暂时禁用——比如风控触发、欠费等。被禁用时业务接口会返回 403。
  • 批量申请 N 个服务:先调 services/?limit=100 拿到所有 service_id,然后并发调本接口,遇到 duplication 跳过即可。

相关接口

API 开发教程

OpenCode 的 Coding Plan 模型 Provider、IDE Extension 与 MCP 是三项独立能力。IDE Extension 连接本地 OpenCode runtime,并复用同一份 Provider 配置;它不代表宿主编辑器原生支持 Ace Data Cloud。

路线 说明 链接 状态
Terminal / CLI / TUI Provider 使用 opencode.json[c] 和 Chat Completions Provider 配置 已验证配置合同
IDE Extension VS Code、Cursor、Windsurf、VSCodium 等宿主连接 OpenCode runtime IDE 配置 实验性
MCP 在 OpenCode 内调用远程工具 MCP 总览 独立能力

Provider 配置成功后,IDE Extension 应使用相同的 Provider 与模型。仍需分别验证 IDE 内聊天、文件读取、编辑与工具调用,不应把 CLI 的一次普通请求自动外推为全部 IDE 能力。

模型 ID 以 实时目录 为准。

官方参考

返回 Coding Plan 配置中心。

技术教程

出海全球

很多人做 Ace Data Cloud 分销,只盯着国内。但这个平台本身就是全球化的:API 以美元定价、界面中英双语、支持 Stripe 全球支付、GitHub/Google 一键登录。

面向海外推广仍然遵循同一套客户归属与结算规则,但渠道竞争、获客成本、支付方式和用户需求会因市场而异。本文只讲如何用英文内容测试不同渠道。

快速入口:

为什么值得做出海推广

  • 受众更广。 海外开发者和企业也可能需要 AI API,但付费意愿、使用周期和采购要求因市场与团队而异。
  • 渠道不同。 英文技术社区有自己的内容规范和竞争环境,应先提供可复现的技术内容,再观察真实反馈。
  • 跨地区结算。 支付方式、结算币种、提现条件和汇率影响以当前页面及账户所在地区为准。

佣金只来自符合当前规则的有效订单。等级、比例、邀请归属、确认期和提现条件以推广方式与佣金规则及分销后台当前显示为准;退款、风控、订单状态和既有邀请关系都可能影响最终结果。

海外推广平台攻略

Medium — 长文评测的最佳阵地

Medium 是海外开发者常看的技术博客平台,适合承载深度评测。

选题参考:

  • “Suno API Review: Generate Music with AI in Seconds”
  • “Midjourney API vs gpt-image-2: An Honest Developer Comparison”
  • “I Built a Video App Using the Sora API — Here’s How”
  • “The Best Multi-Model AI Chat API for Developers in 2026”

技巧: 标题带具体 API 名(SEO 关键词);正文放可运行代码(海外开发者就爱看代码);自然嵌入你的邀请链接;打上 #AI #API #MachineLearning #SaaS 标签。一篇扎实的技术评测,长尾流量能持续很久——写一次,长期带量。

Medium 也在平台支持 AI 自动发布的渠道列表里(配合定时任务可半自动产出,见文末)。

Reddit — 开发者聚集地

相关社区很多,如 r/artificial、r/MachineLearning、r/SideProject、r/SaaS。

Reddit 极度反感硬广,必须”价值优先”:

  1. 先在社区活跃一段时间,真诚回答问题、建立信誉
  2. 分享你用API Platform 做的项目:”Show r/SideProject: I built an AI music generator using the Suno API”
  3. 评论区有人问 “How did you do it?” 时,再自然给出平台链接
  4. 别直接发纯推广帖,会被秒删

Hacker News & Product Hunt — 科技圈爆发力

  • Hacker News: 有用API Platform 做的产品,可以发一个 “Show HN” 帖子。
  • Product Hunt: 把你的 AI 项目或已经完成验收的白牌站提交上去,一次成功 launch 能带来集中曝光。

先把产品/内容做好,再去这些渠道——它们奖励真东西,惩罚硬广。

X (Twitter) — 日常曝光引擎

AI 圈在 X 上很活跃。日常可以发:用API Platform 生成的作品(配 “Made with Ace Data Cloud API”)、API 小技巧和代码片段、模型对比测试。多参与话题讨论、回复相关帖子,关注 #AIdev #BuildInPublic #IndieHacker 标签。X 也是平台支持自动发布的渠道之一。

Stack Overflow — 精准技术流量

当开发者搜 “Suno API Python example” 这类问题时,Stack Overflow 常排在前面。搜相关问题、写高质量回答,在回答里引用API Platform 文档作为参考资源。

Discord — 社区深度运营

加入 Midjourney、Suno、Luma 等官方 Discord,帮别人解决 API 使用问题、建立专家形象;也可以自建一个英文 AI 社群阵地。

英文内容不发愁:用平台的 AI 帮你写和配图

英文不够地道?用平台自己的 AI Chat(GPT / Claude)把中文草稿翻译并润色成地道英文技术文章:

  1. 中文写好大纲和核心观点
  2. 让 AI 翻译并按 Medium / Dev.to 风格润色
  3. 人工核对技术细节(API 地址、代码示例必须自己验证)
  4. 加上邀请链接后发布

配图用最火的 gpt-image-2,几秒出一张杂志级封面:

1
2
3
4
curl -X POST https://api.acedata.cloud/openai/images/generations \
-H "Authorization: Bearer $ACEDATACLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"minimalist tech blog cover, AI API concept, deep blue gradient","size":"1536x1024"}'

要做带 logo 的联名封面,用 POST https://api.acedata.cloud/openai/images/edits(multipart,image[] 可传多张,把官方 logo 底图 https://cdn.acedata.cloud/1mma4f.png 和你的图一起融合)。在线界面:https://studio.acedata.cloud/openai-image。

持续发布经过核实的英文内容,并通过分销后台观察是否产生真实注册和有效订单。

半自动化:让 AI 定时发英文内容

平台支持连接你的 Medium / X 等账号,再用定时任务无人值守发布:

平台的全球化优势(你不用做本地化)

  • 双语文档:platform.acedata.cloud 中英切换,API 文档全英文
  • 全球支付:支持 Stripe 信用卡/借记卡,覆盖主流货币
  • 美元计价:价格本身就是美元,海外用户零换算门槛
  • 多种登录:GitHub、Google 登录,海外开发者秒注册
  • 消费级应用:studio.acedata.cloud 中英双语,非技术用户也能用

平台把国际化做好了,你只管把它介绍给世界。

进阶:发展海外二级推广者

如果海外社区中有人也愿意分享真实使用经验,可以邀请他们先阅读组建推广团队和推广方式与佣金规则。合作范围和最终结算以后台记录为准。

开始行动

  1. 注册 Ace Data Cloud(GitHub/Google 一键登录)
  2. 进入分销后台拿到邀请链接
  3. 选一个海外平台起步(推荐 Medium 或 X)
  4. 本周发出第一篇英文 AI API 评测(用 gpt-image-2 配张封面)
  5. 佣金确认与提现条件以分销后台当前显示为准,需要协助可联系客服

用真实、专业、可复现的内容测试不同海外渠道,再根据实际注册和有效订单决定投入。

API 开发教程

本文将介绍一种 SeeDance Videos Generation API 对接说明,它是可以通过输入自定义参数来生成SeeDance官方的视频。

申请流程

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

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

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

📘 完整文档:SeeDance Videos Generation API →

基本使用

首先先了解下基本的使用方式,就是输入提示词 content.text、类型content.type=text 以及模型 model,便可获得处理后的结果,具体的内容如下:

可以看到这里我们设置了 Request Headers,包括:

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

另外设置了 Request Body,包括:

  • model:生成视频的模型。
    • Seedance 1.x 系列:doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015、doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428。
    • Seedance 2.0 系列(支持角色和音视频多模态参考):doubao-seedance-2-0-260128(标准)、doubao-seedance-2-0-fast-260128(快速)、doubao-seedance-2-0-mini-260615(轻量)。
    • Seedance 2.5:doubao-seedance-2-5-260628,支持最长 30 秒、纯音频参考、更多素材、视频编辑与延长。
  • content:输入内容数组,type 可以是 text(提示词)、image_url(参考图片)、audio_url(参考音频)、video_url(参考视频)。图片可通过 role 指定用途:first_frame(首帧)/ last_frame(尾帧)/ reference_image(角色 / 主体参考)。
  • resolution:输出分辨率,可选 480p / 720p / 1080p / 4k。2.5 支持 480p、720p、1080p;2.0 Fast/Mini 支持 480p、720p;2.0 Standard 最高支持 4k。
  • ratio:宽高比,可选 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive。
  • duration:视频时长(秒,整数)。1.0 系列 2–12;1.5 Pro 4–12;2.0 系列 4–15;2.5 为 4–30。1.5/2.x 支持 -1(自动时长)。
  • seed:随机种子,整数,-1 到 4294967295。
  • camerafixed:是否固定摄像头,true / false。
  • watermark:是否添加水印,true / false。
  • generate_audio:是否生成有声视频,true / false,Seedance 1.5 Pro 与 2.x 系列支持。
  • return_last_frame:是否在结果中返回视频最后一帧图片 URL。
  • omni_reference_task_type:仅 2.5;auto / edit / extend。
  • output_format:仅 2.5;mp4 / mov,默认 mp4。
  • tools:仅 2.5;当前支持 web_search 联网检索工具,可限制结果数、关键词数和搜索来源。
  • priority:2.5 可选任务优先级,整数 0–9,默认 0。
  • safety_identifier:最长 64 字符的稳定匿名终端用户标识;请使用哈希或内部匿名 ID,不要传入姓名、邮箱或手机号。
  • execution_expires_after:任务超时时间(秒),范围 3600–259200。
  • callback_url:异步回调地址,设置后 API 立即返回 task_id,任务完成时将结果 POST 到该地址。
  • async:可选,设为 true 时接口立即返回 task_id,无需提供 callback_url,随后通过对应的任务查询接口轮询获取结果。

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"success": true,
"task_id": "9777f36b-4f44-47ff-962d-45cd2f7aeaa8",
"trace_id": "ce5da2ca-6695-4459-9d2c-2ef9f86db752",
"data": {
"task_id": "7e4e1773-510a-4a73-9ab4-98dd1a0b2a7f",
"status": "succeeded",
"model": "doubao-seedance-2-0-fast-260128",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"video_url": "https://platform2.cdn.acedata.cloud/seedance/036f24ed-a9b1-49b3-92c4-30049a3bc152.mp4"
}
}

返回结果一共有多个字段,介绍如下:

  • success,此时视频生成任务的状态情况。
  • task_id,此时视频生成任务ID。
  • trace_id,此时视频生成跟踪ID。
  • data,此时视频生成任务的结果列表。
    • task_id,此时视频生成任务的服务器端ID。
    • video_url,此时视频生成任务的视频链接。
    • status,此时视频生成任务的状态。
      • model,生成视频使用的模型。

可以看到我们得到了满意的视频信息,我们只需要根据结果中 data 的视频链接地址获取生成的SeeDance视频即可。

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

1
2
3
4
5
6
7
8
9
10
11
curl -X POST 'https://api.acedata.cloud/seedance/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"content": [{"type":"text","text":"A white ceramic coffee mug on a glossy marble countertop with soft morning window light. The camera slowly orbits 360 degrees around the mug, steam gently rising."}],
"model": "doubao-seedance-2-0-fast-260128",
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'

内联参数说明

在 content[].text 提示词末尾,可以通过追加 --parameter value 的形式传入生成参数(旧方式,弱校验,填写有误时自动使用默认值)。完整参数列表如下:

内联参数 对应字段 说明 取值范围
--rs resolution 输出分辨率 480p / 720p / 1080p
--rt ratio 宽高比 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive
--dur duration 视频时长(秒) 2–12
--frames frames 视频帧数 [29, 289] 中满足 25+4n 的整数(仅 1.0 系列支持)
--fps framespersecond 帧率 仅支持 24
--seed seed 随机种子 -1 到 4294967295
--cf camerafixed 是否固定摄像头 true / false
--wm watermark 是否添加水印 true / false

推荐做法:直接在 Request Body 中使用对应的顶层字段(如 resolution、ratio 等),为强校验模式,参数填写有误时会返回明确错误提示,更易于排查问题。

生成有声视频

Seedance 1.5 Pro 与 2.x 系列支持通过 generate_audio 参数生成带音频的视频:

1
2
3
4
5
6
7
8
9
10
11
12
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "A girl holds a fox, the wind blows her hair, you can hear the sound of the wind"
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 5
}

1.0 系列不支持此参数。

Seedance 2.5 全模态生成、编辑与延长

doubao-seedance-2-5-260628 支持 480p / 720p / 1080p、4–30 秒或自动时长,并把素材上限提高到 30 张参考图、10 段参考视频、10 段参考音频(总计最多 50 个)。2.5 还支持仅传参考音频,不再要求同时提供图片或视频。

普通全模态生成可省略 omni_reference_task_type,或设为 auto。视频编辑与延长必须传入 reference_video:

1
2
3
4
5
6
7
8
9
10
11
12
{
"model": "doubao-seedance-2-5-260628",
"content": [
{"type": "text", "text": "Replace the sky with a warm sunset while preserving the subject and camera motion."},
{"type": "video_url", "role": "reference_video", "video_url": {"url": "https://cdn.acedata.cloud/input.mp4"}}
],
"resolution": "720p",
"ratio": "adaptive",
"duration": -1,
"omni_reference_task_type": "edit",
"output_format": "mov"
}
  • edit:必须使用 ratio: adaptive 和 duration: -1;输出时长按实际结果计费。
  • extend:必须使用 ratio: adaptive;duration 可为 4–30 或 -1。
  • auto:模型根据提示词和素材自动选择生成、编辑或延长。
  • 任务类型与素材或提示词不匹配时,任务会失败并返回可定位的参数错误;请按上述约束调整后重新提交。

图生视频首帧

如果想图生视频任务,首先 content 参数需要包含 type 为 image_url 的项,image_url 字段必须为对象格式:{"url": "https://..."} 或 Base64 格式 {"url": "data:image/png;base64,..."}。

注意:image_url 不支持直接传入字符串格式(如 "image_url": "https://cdn.acedata.cloud/e724d7f13d.png"),必须使用对象格式 "image_url": {"url": "https://..."},否则会返回 400 错误。

对应的代码:

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
import requests

url = "https://api.acedata.cloud/seedance/videos"

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

payload = {
"content": [
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
}
},
{
"type": "text",
"text": "A girl holds a fox in her arms. She opens her eyes and gazes tenderly at the camera, while the fox affectionately holds her back. As the camera slowly pulls away, her hair is gently blown by the wind. --ratio adaptive --dur 5"
}
],
"model": "doubao-seedance-1-0-pro-250528"
}

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

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

1
2
3
4
5
6
7
8
9
10
11
{
"success": true,
"task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
"trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4",
"data": {
"task_id": "cgt-20251222072003-x2259",
"status": "succeeded",
"video_url": "https://platform.cdn.acedata.cloud/seedance/6afb78b8-5ba8-424f-adcd-69423a700b50.mp4",
"model": "doubao-seedance-1-0-pro-250528"
}
}

可以看到,生成的效果是图生建视频的,结果与上文类似。

图生视频首尾帧

如果想图生视频首尾帧, 首先参数content必须传入类型image_url,并且分别设置role为first_frame和last_frame,就可以指定如下内容:

  • role:指定首帧或者尾帧。
  • image_url
    • url 图片链接
      同时 content 还需要输入类型text作为prompt提示词

对应的代码:

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
import requests

url = "https://api.acedata.cloud/seedance/videos"

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

payload = {
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{
"type": "text",
"text": "360-degree shot"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
},
"role": "last_frame"
}
]
}

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

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

1
2
3
4
5
6
7
8
9
10
11
{
"success": true,
"task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
"trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
"data": {
"task_id": "cgt-20251222073134-54qcw",
"status": "succeeded",
"video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
"model": "doubao-seedance-1-0-pro-250528"
}
}

可以看到,生成的效果是角色生成视频,结果与上文类似。

角色与音视频多模态参考(Seedance 2.0)

Seedance 2.0 系列(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615)支持 reference_image、reference_audio 与 reference_video。可使用自有或已获授权的素材保持角色、主体、动作、运镜、声音与节奏的一致性。

请仅上传自有或已获授权的真人与角色素材。不同模型对真人素材的支持方式不同;请求格式保持不变,若素材不符合要求会返回明确错误。

使用要点:

  • 仅 Seedance 2.0 系列模型支持 reference_image;1.x 模型请使用 first_frame / last_frame(图生视频首尾帧)。
  • reference_image 不能与 first_frame / last_frame 混用,二者只能择一。
  • 多模态参考数量上限:image_url 最多 9 张;2.0 还支持 audio_url(role 为 reference_audio,最多 3 条)与 video_url(role 为 reference_video,最多 3 条)。
  • 参考音频(audio_url)素材要求:格式 wav / mp3;单条时长 2~15 秒,最多 3 条且总时长不超过 15 秒;单条不超过 15 MB。超出时长范围会在素材处理阶段失败。
  • 参考视频(video_url)素材要求:格式 mp4 / mov;单条时长 2~15 秒,最多 3 条且总时长不超过 15 秒。
  • 参考图片建议使用单人、正脸、清晰、无遮挡的照片,人脸越清晰,相似度越高。

示例一:保持人物样貌的特写

传入一张人脸照片,让该人物对着镜头微笑挥手。对应的代码:

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 requests

url = "https://api.acedata.cloud/seedance/videos"

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

payload = {
"model": "doubao-seedance-2-0-fast-260128",
"content": [
{
"type": "text",
"text": "The woman looks at the camera, gives a warm natural smile and waves her hand, soft studio lighting, gentle camera push-in."
},
{
"type": "image_url",
"role": "reference_image",
"image_url": {
"url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.jpg"
}
}
],
"resolution": "480p",
"ratio": "9:16",
"duration": 5
}

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
{
"success": true,
"task_id": "895eb5ea-bbe1-41a3-a9e9-48608e03f93a",
"trace_id": "83544791-7a84-44de-b8d2-afe171a1c0e4",
"data": {
"task_id": "458abf29-cc39-4fd0-bcea-24f89a70d8de",
"status": "succeeded",
"video_url": "https://platform2.cdn.acedata.cloud/seedance/e71d3cc5-27e7-4719-be34-1f0e254eccaf.mp4",
"model": "doubao-seedance-2-0-fast-260128",
"resolution": "480p",
"ratio": "9:16",
"duration": 5
}
}

示例二:把同一个人放进全新场景

reference_image 的强大之处在于:只保留人物身份,而场景、服装、动作完全由提示词决定。下面用同一张人脸照片,让该人物身着米色大衣走在秋日公园里:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"model": "doubao-seedance-2-0-fast-260128",
"content": [
{
"type": "text",
"text": "The same woman wearing a beige coat walks through a sunny autumn park, golden leaves falling around her, she smiles softly at the camera, cinematic tracking shot."
},
{
"type": "image_url",
"role": "reference_image",
"image_url": {
"url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.jpg"
}
}
],
"resolution": "720p",
"ratio": "9:16",
"duration": 5
}

返回结果如下,人物样貌得以保留,而场景已切换为秋日公园:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"success": true,
"task_id": "00872de7-16b7-431f-b4f7-6bf38ae86157",
"trace_id": "577a07c3-4f5f-4cc7-86fe-535bb8332614",
"data": {
"task_id": "32fe1537-ba3e-452a-8749-3ef8890d37fd",
"status": "succeeded",
"video_url": "https://platform2.cdn.acedata.cloud/seedance/44f47593-556b-4fda-afa5-7a71eefcd228.mp4",
"model": "doubao-seedance-2-0-fast-260128",
"resolution": "720p",
"ratio": "9:16",
"duration": 5
}
}

💡 若想让人物精确复刻照片中的构图(而非「换个场景的同一个人」),可改用 first_frame(图生视频首帧),让视频从这张照片开始运动。

异步回调

由于 SeeDance Videos Generation API 生成时间较长(约 1-2 分钟),可通过 callback_url 字段使用异步模式,避免 HTTP 连接长时间占用。

整体流程:客户端发起请求时指定 callback_url,API 立即返回包含 task_id 的响应;任务完成后,平台将生成结果以 POST JSON 的形式发送到 callback_url,结果中同样包含 task_id 以便关联。

1
2
3
{
"task_id": "f7096c6c-9430-4392-8201-d259632d7afd"
}

任务完成时,平台推送到 callback_url 的内容如下:

1
2
3
4
5
6
7
8
9
10
11
{
"success": true,
"task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
"trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
"data": {
"task_id": "cgt-20251222073134-54qcw",
"status": "succeeded",
"video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
"model": "doubao-seedance-1-0-pro-250528"
}
}

结果中的 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"
}

结论

通过本文档,您已经了解了如何使用 Seedance Videos Generation API 进行文生视频、首尾帧与多模态参考生成,以及使用 Seedance 2.5 编辑或延长视频。希望本文档能帮助您完成 API 对接;如有问题,请联系技术支持。

API 开发教程

OpenAI ChatGPT 是一款非常强大的 AI 对话系统,只要输入提示词,就能在短短几秒内生成流畅自然的回复。ChatGPT 以其出色的语言理解和生成能力在业界独树一帜,如今,ChatGPT 早已在各个行业和领域广泛应用,其影响力愈发显著。无论是日常对话、创意写作,还是专业咨询、代码编程,ChatGPT 都能提供令人惊叹的智能协助,极大地提高了人类的工作效率和创造力。

本文档主要介绍 OpenAI Chat Completion API 操作的使用流程,利用它我们可以轻松使用官方 OpenAI ChatGPT 的对话功能。

申请流程

要使用 OpenAI Chat Completion API,首先到 Ace Data Cloud 控制台 获取您的 API Token,留作备用。

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

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

📘 完整文档:OpenAI Chat Completion API →

基本使用

接下来就可以在界面上填写对应的内容,如图所示:

在第一次使用该接口时,我们至少需要填写三个内容,一个是 authorization,直接在下拉列表里面选择即可。另一个参数是 model, model 就是我们选择使用 OpenAI ChatGPT 官网模型类别,这里我们主要有 20 种模型,详情可以看我们提供的模型。最后一个参数是messages,messages是我们输入的提问词数组,它是一个数组,表示可以同时上传多个提问词,每个提问词包含了 role 和 content,其中 role 表示提问者的角色,我们提供了三种身份,分别为 user 、assistant、system 。另一个 content 就是我们提问的具体内容。

同时您可以注意到右侧有对应的调用代码生成,您可以复制代码直接运行,也可以直接点击「Try」按钮进行测试。

常用可选参数:

  • max_tokens:限制单次回复的最大 token 数。
  • temperature:生成随机性,0-2 之间,值越大越发散。
  • n:一次生成多少条候选回复。
  • response_format:返回格式设置。

调用之后,我们发现返回结果如下:

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
{
"id": "chatcmpl-Cmd6uwSxN75F4PAdQSFEO8f2QPs4E",
"object": "chat.completion",
"created": 1765706120,
"model": "gpt-5.5",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! What can I help you with today?",
"refusal": null,
"annotations": []
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 7,
"completion_tokens": 13,
"total_tokens": 20,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
},
"service_tier": "default",
"system_fingerprint": null
}

返回结果一共有多个字段,介绍如下:

  • id,生成此次对话任务的 ID,用于唯一标识此次对话任务。
  • model,选择的 OpenAI ChatGPT 官网模型。
  • choices,ChatGPT 针对提问词给于的回答信息。
  • usage:针对本次问答对 token 的统计信息。

其中 choices 是包含了 ChatGPT 的回答信息,它里面的 choices 是 ChatGPT,可以发现如图所示。

可以看到,choices 里面的 content 字段包含了 ChatGPT 回复的具体内容。

流式响应

该接口也支持流式响应,这对网页对接十分有用,可以让网页实现逐字显示效果。

如果想流式返回响应,可以更改请求头里面的 stream 参数,修改为 true。

修改如图所示,不过调用代码需要有对应的更改才能支持流式响应。

将 stream 修改为 true 之后,API 将逐行返回对应的 JSON 数据,在代码层面我们需要做相应的修改来获得逐行的结果。

Python 样例调用代码:

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/openai/chat/completions"

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

payload = {
"model": "gpt-4",
"messages": [{"role":"user","content":"hello"}],
"stream": True
}

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
data: {"choices": [{"delta": {"role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": "Hi", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " there", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": "!", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " How", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " can", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " I", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " assist", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " you", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": " today", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"content": "?", "role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"role": "assistant"}, "index": 0}], "created": 1721007348, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: {"choices": [{"delta": {"role": "assistant"}, "finish_reason": "stop", "index": 0}], "created": 1721007349, "id": "chatcmpl-YzczYjVhNjhjMzMwNDQ5MDkyNGYzOGZjZGE1ZGQ5OGU", "model": "gpt-4", "object": "chat.completion.chunk", "recipient": "all"}

data: [DONE]

可以看到,响应里面有许多 data ,data 里面的 choices 即为最新的回答内容,与上文介绍的内容一致。choices 是新增的回答内容,您可以根据结果来对接到您的系统中。同时流式响应的结束是根据 data 的内容来判断的,如果内容为 [DONE],则表示流式响应回答已经全部结束。返回的 data 结果一共有多个字段,介绍如下:

  • id,生成此次对话任务的 ID,用于唯一标识此次对话任务。
  • model,选择的 OpenAI ChatGPT 官网模型。
  • choices,ChatGPT 针对提问词给于的回答信息。

JavaScript 也是支持的,比如 Node.js 的流式调用代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
const options = {
method: "post",
headers: {
accept: "application/json",
authorization: "Bearer {token}",
"content-type": "application/json",
},
body: JSON.stringify({
model: "gpt-4",
messages: [{ role: "user", content: "hello" }],
stream: true,
}),
};

fetch("https://api.acedata.cloud/openai/chat/completions", options)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

Java 样例代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
JSONObject jsonObject = new JSONObject();
jsonObject.put("model", "gpt-4");
jsonObject.put("messages", [{"role":"user","content":"hello"}]);
jsonObject.put("stream", true);
MediaType mediaType = "application/json; charset=utf-8".toMediaType();
RequestBody body = jsonObject.toString().toRequestBody(mediaType);
Request request = new Request.Builder()
.url("https://api.acedata.cloud/openai/chat/completions")
.post(body)
.addHeader("accept", "application/json")
.addHeader("authorization", "Bearer {token}")
.addHeader("content-type", "application/json")
.build();

OkHttpClient client = new OkHttpClient();
Response response = client.newCall(request).execute();
System.out.print(response.body!!.string())

其他语言可以另外自行改写,原理都是一样的。

多轮对话

如果您想要对接多轮对话功能,需要对 messages 字段上传多个提问词,多个提问词的具体示例如下图所示:

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/openai/chat/completions"

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

payload = {
"model": "gpt-4",
"messages": [{"role":"user","content":"Hello"},{"role":"assistant","content":"Hi! How can I assist you today?"},{"role":"user","content":"What I say just now?"}]
}

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
{
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "You said, \"Hello.\""
},
"finish_reason": "stop"
}
],
"created": 1721323012,
"id": "chatcmpl-NWZmOTA5MDlkZjBjNDRjNGEwMzRjYzA5NmM1MzQwMWY",
"model": "gpt-4",
"object": "chat.completion.chunk",
"recipient": "all",
"usage": {
"prompt_tokens": 31,
"completion_tokens": 6,
"total_tokens": 37
}
}

可以看到,choices 包含的信息与基本使用的内容是一致的,这个包含了 ChatGPT 针对多个对话进行回复的具体内容,这样就可以根据多个对话内容来回答对应的问题了。

对接 OpenAI-Python

OpenAI Chat Completion API 与官方 OpenAI 接口保持兼容,可直接使用官方 SDK OpenAI-Python 对接,本文将简要介绍使用方式。

  1. 首先需要搭建本地 Python 环境,此过程可谷歌搜索一下。
  2. 下载安装开发环境,比如安装 VSCode 编辑器。
  3. 配置 OpenAI 环境变量。
  • 在项目文件夹里,创建一个名为 .env 的文件,并保存
  • .env 文件内容:
1
2
OPENAI_API_KEY="sk-xxx"
OPENAI_BASE_URL="https://api.acedata.cloud/openai" # 再次提醒:如果你使用官网OpenAI的key,不要用这个地址。

sk-xxx 使用自己的 key 替换。OPENAI_BASE_URL 是访问 OpenAI 的代理接口。

  1. 安装项目依赖的包
1
pip install openai

Mac OS 中命令为:

1
pip3 install openai
  1. 创建示例源代码文件

假设我们创建了一个示例代码 index.py ,具体内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import os
from openai import OpenAI


client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))

response = client.chat.completions.create(
messages=[
{
"role": "user",
"content": "hello",
}
],
model="gpt-4",
)

print(response.text)

联网模型

gpt-3.5-browsing 和 gpt-4-browsing 模型与其它模型不同,它可以根据提问词来进行联网搜索,并且将联网搜索的结果进行适当的调整返回给你,本文将通过一个具体示例来演示联网功能,接下来就可以在 OpenAI Chat Completion API 界面上填写对应的内容,如图所示:

同时您可以注意到右侧有对应的调用代码生成,您可以复制代码直接运行,也可以直接点击「Try」按钮进行测试。

调用之后,我们发现返回结果如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "For the latest news in China today, you can check major news websites such as:\n\n- [BBC News China](https://www.bbc.com/news/world/asia/china)\n- [CNN China News](https://edition.cnn.com/china)\n- [Reuters China](https://www.reuters.com/news/archive/china-news)\n\nThese sources will have up-to-date information on current events in China."
},
"finish_reason": "stop"
}
],
"created": 1721009347,
"id": "chatcmpl-YzA0M2RjZDVkYThlNDkxNTkzOThmZWQ4OGMzNzdhNzA",
"model": "gpt-4-browsing",
"object": "chat.completion.chunk",
"recipient": "all",
"usage": {
"prompt_tokens": 325,
"completion_tokens": 82,
"total_tokens": 407
}
}

可以看到,choices 里面的回答信息是根据联网查询后得到的,并且也给出了相关的链接,choices 里面的回答信息是要通过 markdown 语法进行渲染,这样才能获得最佳的体验,最后这也体现出我们模型的联网功能的强大优势。

视觉模型

gpt-4o 是 OpenAI 开发的多模态大型语言模型,它在 GPT-4 的基础上增加了视觉理解能力。这个模型可以同时处理文本和图像输入,实现了跨模态的理解和生成。

使用 gpt-4o 模型的文本处理是与上文的基本使用内容一致的,下面将简要介绍一下如果使用模型的图像处理能力。

使用 gpt-4o 模型的图像处理能力主要是通过在原有的 content 内容基础上添加一个 type 字段,通过该字段可以知道上传的是文本还是图片,从而使用 gpt-4o 模型的图像处理能力,下面主要讲述采用 Curl 和 Python 俩种方式来调用该功能。

  • Curl 脚本方式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
curl -X POST 'https://api.acedata.cloud/openai/chat/completions' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "What'\''s in this image?"
},
{
"type": "image_url",
"image_url": {
"url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
}
}
]
}
]
}'
  • Python 脚本方式
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 requests

url = "https://api.acedata.cloud/openai/chat/completions"

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

payload = {
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": [
{
"type": "text", "text": "What's in this image?"
},
{
"type": "image_url",
"image_url": {
"url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
}
},
],
}
]
}

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
{
"id": "chatcmpl-123",
"object": "chat.completion",
"created": 1677652288,
"model": "gpt-4-vision-preview",
"system_fingerprint": "fp_44709d6fcb",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\nThis image shows a wooden boardwalk extending through a lush green marshland."
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 9,
"completion_tokens": 12,
"total_tokens": 21
}
}

可以看到回答的内容是基于图片进行回答的,因此通过上述俩种方式可以轻松使用 gpt-4-vision 模型的文本和图像处理能力。

除了,gpt-4o,还有一个更低成本的模型,叫做 gpt-4o-mini。gpt-4o-mini 是 OpenAI 开发的最新一代大型语言模型,它不仅响应速度快,同时价格也更便宜,也支持多模态。vision 功能的使用可参考上文 gpt-4o 模型的使用的内容。

GPT-4o 绘图模型

根据参考图进行生图

下面是根据一个图片生成自定义风格的图片的示例,首先让我们看一下我们输入的图片,如下图所示:

可以看到参考图是一个真人的图片,我们可以让它变化一种风格,比如让它变成动漫风格的图像,具体的请求样例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "生成动漫风格的图片,并且带上个帽子"
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/qzx2z1.png"
}
}
]
}
],
"stream": false
}

样例结果:

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
{
"id": "chatcmpl-89DPQxbLuyRNzH5YLCPYM5WElV3dm",
"object": "chat.completion",
"created": 1781020664,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 生成中...\n\n![https://platform.cdn.acedata.cloud/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png](https://platform.cdn.acedata.cloud/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png)\n\n[点击下载](https://platform.cdn.acedata.cloud/download/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 100,
"completion_tokens": 122,
"total_tokens": 222,
"prompt_tokens_details": {
"text_tokens": 93,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}

其中 choices 里面的 message.content 就是生成的完整对话结果,图片以 Markdown 格式包含在其中(图片链接为临时地址,请及时下载保存)。可以看出生成的图片确实是动漫风格的,具体的如下图所示:

纯文字生图

我们可以通过一个提示词让它生成图片,并且以对话式的结果返回给我们,下面我们以创建一张未来城市日落的图片为示例,下面具体的示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "创建一张未来城市日落的图片"
}
]
}
],
"stream": false
}

样例结果:

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
{
"id": "chatcmpl-89DqkpQoPGkQqJ6kPKMKWejjLXVxQ",
"object": "chat.completion",
"created": 1781020587,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 生成中...\n\n![https://platform.cdn.acedata.cloud/20260609/ed2cca68732540fc99162ddc10ddc153.png](https://platform.cdn.acedata.cloud/20260609/ed2cca68732540fc99162ddc10ddc153.png)\n\n[点击下载](https://platform.cdn.acedata.cloud/download/20260609/ed2cca68732540fc99162ddc10ddc153.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 17,
"completion_tokens": 104,
"total_tokens": 121,
"prompt_tokens_details": {
"text_tokens": 10,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}

可以看到结果是符合提示词的,具体的如下所示:

多图生一图

我们还可以使用使用多张参考图来生成一张图,比如使用一张帅哥和咖啡图,利用这俩张图可以生成一张帅哥喝咖啡的图,下面是具体的参考图:

下面我们以生成男生举着咖啡,并且马上要喝的样子为示例,下面具体的示例:

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
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "生成男生举着咖啡,并且马上要喝的样子"
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/pqquv3.jpg"
}
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/h8j2i0.jpg"
}
}
]
}
],
"stream": false
}

样例结果:

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
{
"id": "chatcmpl-89DnHbbzOIQvU1VzJrNjzMU8BRUgG",
"object": "chat.completion",
"created": 1781021018,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 生成中...\n\n![https://platform.cdn.acedata.cloud/20260610/f1d9ddee3c304230a9f92929f04b95be.png](https://platform.cdn.acedata.cloud/20260610/f1d9ddee3c304230a9f92929f04b95be.png)\n\n[点击下载](https://platform.cdn.acedata.cloud/download/20260610/f1d9ddee3c304230a9f92929f04b95be.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 193,
"completion_tokens": 116,
"total_tokens": 309,
"prompt_tokens_details": {
"text_tokens": 186,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}

可以看到,生成的结果确实是结合了俩张图来生成的,下面是具体的结果:

错误处理

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

结论

通过本文档,您已经了解了如何使用 OpenAI Chat Completion API 轻松实现官方 OpenAI ChatGPT 的对话功能。希望本文档能帮助您更好地对接和使用该 API。如有任何问题,请随时联系我们的技术支持团队。

API 开发教程

本文将介绍一种 Pixverse Videos Generation API 对接说明,它是可以通过输入自定义参数来生成Pixverse官方的视频。

申请和使用

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

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

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

📘 完整文档:Pixverse Videos Generation API →

基本使用

可以根据提示词来生成视频,比如可以输入 quiver,如图所示:

生成的代码如下:

主要请求参数:

  • model:生成视频的模型,默认 v3.5。
  • action:生成视频行为,默认 generate,可选 extend。
  • prompt:生成视频的提示词(必填)。
  • style:可选的视频风格。
  • motion:运动模式,默认 normal。
  • quality:视频清晰度,默认 540p。
  • duration:视频时长,5 或 8 秒,默认 5。
  • image_url:首帧参考图,可选。
  • aspect_ratio:宽高比,默认 16:9。
  • seed:可选,固定随机种子。
  • template_id:可选,指定模版特效。
  • callback_url:需要回调结果的 URL。
  • async:可选,设为 true 时接口立即返回 task_id,无需提供 callback_url,随后通过对应的任务查询接口轮询获取结果。

可以点击「Try」按钮直接测试 API,稍等 1-2 分钟,结果如下:

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
{
"success": true,
"task_id": "69e677ca-f1de-419f-99a4-cb39ea0cb5fc",
"trace_id": "e544f904-ac13-4b42-a26e-2de69d9ac06b",
"data": [
{
"id": 317982208110208,
"first_frame": "",
"video_width": 0,
"video_height": 0,
"prompt": "quiver",
"model": "v3.5",
"quality": "360p",
"motion": "normal",
"video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
"template_id": 0,
"template_name": "",
"style": "",
"aspect_ratio": "16:9",
"duration": 5,
"extended": 0,
"last_frame": "",
"seed": 0,
"asset_id": 0,
"asset_name": ""
}
]
}

可以看到这时候我们就得到了一个视频的内容,包括视频ID、视频链接、视频清晰度、视频时长等内容。

字段说明如下:

  • success:生成是否成功,如果成功则为 true,否则为 false
  • task_id:此次生成任务的ID
  • trace_id:此次生成任务的追踪ID
  • data:是一个列表,包含了生成的视频的详细信息。
    • id: 生成视频的唯一ID,后续可以根据此ID进行扩展生成
    • first_frame:视频的首帧图片链接
    • last_frame:视频的尾帧图片链接
    • video_width:此次视频结果的宽度
    • video_height:此次视频结果的长度
    • prompt:此次视频生成任务的提示词
    • model:此次视频生成任务采用的模型
    • video_url:此次视频生成任务的视频链接
    • template_id:视频采用的模版特效ID
    • template_name:视频采用的模版特效名称
    • asset_id:视频采用的角色ID
    • asset_name:视频采用的角色名称
    • style:此次视频生成任务的风格
    • aspect_ratio:此次视频的尺寸大小
    • extended:此次视频是否为扩展生成的,0为不是扩展生成的,反之为扩展生成的

自定义首尾帧生成视频

如果想自定义首尾帧生成视频,可以输入首尾帧图片链接:

这时候 frame 字段可以传入类似如下内容:

  • 首帧图片

  • 尾帧图片

接下来我们要根据歌词、标题、风格自定义生成歌曲,就可以指定如下内容:

  • action:此次视频生成任务的行为,分为俩种:生成视频 action、扩展视频 extend
  • prompt:此次视频生成任务的提示词。
  • frame:此次视频生成的首尾帧视频链接数组。

填写样例如下:

填写完毕之后自动生成了代码如下:

对应的Shell代码:

1
2
3
4
5
6
7
8
9
curl -X POST 'https://api.acedata.cloud/pixverse/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"action": "generate",
"prompt": "gradation",
"frame": ["https://cdn.acedata.cloud/c7zzmb.png","https://cdn.acedata.cloud/fqd8br.png"]
}'

测试允许,生成的效果是类似的。

自定义视频模板特效生成

如果想使用特定的视频模板特效来生成视频的话,我们只需要添加一个模板ID字段 template_id 来指定模板特效,我们提供了以下几个模板特效,
具体的模板特效如下图所示:

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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
[
{
"display_name": "Muscle Surge",
"workflow_tag": "muscle_241128",
"template_id": 308621408717184,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fwithbaby.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-11-28T17:53:21Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Show off your strong muscles and have everyone hooked.",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"成为肌肉猛男\",\"display_prompt\":\"体验猛男快乐\"}}",
"example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Hug Your Love",
"workflow_tag": "hug_love_241030",
"template_id": 303624424723200,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fhug2.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-10-31T12:07:47Z",
"updated_at": "2025-01-06T05:32:42Z",
"display_prompt": "Hug each other\t",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"爱的抱抱\",\"display_prompt\":\"互相拥抱在一起\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Alive Art",
"workflow_tag": "alive_art_241028",
"template_id": 302325299721280,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Faliveart.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2025-01-06T05:32:53Z",
"display_prompt": "The [OBJECT] comes to life and walks out of the [SCENE]",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"活灵活现\",\"display_prompt\":\"它活了!\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Sheep Curls",
"workflow_tag": "sheep_241208",
"template_id": 310371322329472,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FSheepCurls.gif",
"thumbnail_video_path": "",
"marker": "new",
"created_at": "2024-12-08T15:14:11Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Change hairstyle for a better mood",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"万物皆可羊毛卷\",\"display_prompt\":\"心情不好,换个发型看看\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Sailor Moon",
"workflow_tag": "meishaonv_241225",
"template_id": 313359138372032,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fmeishaonv2.gif",
"thumbnail_video_path": "",
"marker": "",
"created_at": "2024-12-25T12:29:05Z",
"updated_at": "2025-01-06T05:32:33Z",
"display_prompt": "Moon Prism Power, Make Up!",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"成为美少女战士\",\"display_prompt\":\"月之水晶力量,变身!\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Black Myth: Wukong",
"workflow_tag": "heiwukong_241225",
"template_id": 313359209531840,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fmonkey.gif",
"thumbnail_video_path": "",
"marker": "",
"created_at": "2024-12-25T12:29:40Z",
"updated_at": "2025-01-06T05:32:25Z",
"display_prompt": "I am Sun Wukong, the Victorious Fighting Buddha!",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"黑悟空引擎\",\"display_prompt\":\"放马西行,直面天命!\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Santa's Secret Gifts",
"workflow_tag": "santa_gift_241213",
"template_id": 311521768592256,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fgift111.gif",
"thumbnail_video_path": "",
"marker": "new",
"created_at": "2024-12-15T03:16:32Z",
"updated_at": "2024-12-30T06:08:16Z",
"display_prompt": "I want a:",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞礼物盲盒\",\"display_prompt\":\"我想要:\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Where is Santa?",
"workflow_tag": "where_is_santa_241213",
"template_id": 311521879229312,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fwheresanta.gif",
"thumbnail_video_path": "",
"marker": "new",
"created_at": "2024-12-15T03:17:26Z",
"updated_at": "2024-12-30T06:08:24Z",
"display_prompt": "Discovering Santa Claus in the parallel world!",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞老人藏在哪?\",\"display_prompt\":\"“发现”世界各处的圣诞老人\"}}",
"example_list": "[{\"img_id\":119280295,\"img_url\":\"https://media.pixverse.ai/upload%2Fde34a072-325e-4d86-88d9-2daef292e1b4.jpeg\"},{\"img_id\":119280616,\"img_url\":\"https://media.pixverse.ai/upload%2F5b4da0a2-86c3-4204-adda-74bfa7c3d0d1.jpg\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Christmas OOTD",
"workflow_tag": "tobe_santa_241219",
"template_id": 312314911869312,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fbesanta33.gif",
"thumbnail_video_path": "",
"marker": "new",
"created_at": "2024-12-19T14:51:09Z",
"updated_at": "2024-12-30T06:08:08Z",
"display_prompt": "Dress up as a Christmas star",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞战袍\",\"display_prompt\":\"测测什么圣诞装适合你\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "We Are Venom!",
"workflow_tag": "venom_241030",
"template_id": 303624537709312,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FWeAreVenom.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-10-31T12:08:42Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Transform into a [BLACK] Venom",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"毒液变身!\",\"display_prompt\":\"变身成为【黑色】毒液\"}}",
"example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Hot Harley Quinn",
"workflow_tag": "harley_quinn_241121",
"template_id": 307489434436288,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FHotHarleyQuinn.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-22T08:21:19Z",
"updated_at": "2024-12-26T07:40:43Z",
"display_prompt": "Transform into Harley Quinn, mastering allure and chaos",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"小丑女哈莉·奎茵变身\",\"display_prompt\":\"化身小丑女哈莉·奎茵,掌控魅惑与疯狂\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113742000,\"img_url\":\"https://media.pixverse.ai/upload%2F19090035-612e-40ed-9c8d-a7aaf781d492.png\"},{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Crazy Cat Woman",
"workflow_tag": "cat_woman_241121",
"template_id": 307489548427968,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FCrazyCatWoman.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-22T08:22:15Z",
"updated_at": "2024-12-26T07:40:24Z",
"display_prompt": "Transform into a Crazy Cat Woman and slay",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"疯狂猫女变身\",\"display_prompt\":\"变身妖娆猫女,撩翻全场!\"}}",
"example_list": "[{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Wonder Woman",
"workflow_tag": "wonder_woman_241202",
"template_id": 309283958194560,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FWonderWoman.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-12-02T11:45:11Z",
"updated_at": "2024-12-26T07:40:35Z",
"display_prompt": "Transform into Wonder Woman and conquer the impossible",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"神奇女侠变身\",\"display_prompt\":\"成为神奇女侠,征服一切不可能\"}}",
"example_list": "[{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Hulk",
"workflow_tag": "hulk_241106",
"template_id": 304826314164992,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FHulk.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-07T07:08:47Z",
"updated_at": "2024-12-26T07:38:48Z",
"display_prompt": "Unleash the Beast",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"召唤绿巨人\",\"display_prompt\":\"变身成绿巨人并捶爆一切\"}}",
"example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Joker's Rebirth",
"workflow_tag": "joker_241106",
"template_id": 304826126435072,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_joker.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-07T07:07:16Z",
"updated_at": "2024-12-26T07:38:54Z",
"display_prompt": "Transform into a Joker",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"小丑重生\",\"display_prompt\":\"变身成小丑,诡异地微笑\"}}",
"example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Batman",
"workflow_tag": "bat_man_241106",
"template_id": 304826374632192,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_batman.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-07T07:09:17Z",
"updated_at": "2024-12-26T07:39:00Z",
"display_prompt": "Transform into a Batman and embrace the night",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"蝙蝠侠归来\",\"display_prompt\":\"变身成蝙蝠侠并守护黑夜\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Iron Man",
"workflow_tag": "iron_man_241106",
"template_id": 304826054394624,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_ironman.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-07T07:06:40Z",
"updated_at": "2024-12-26T07:39:06Z",
"display_prompt": "Activate Iron Mode",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"钢铁侠变身\",\"display_prompt\":\"激活钢铁模式\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Hair Growth Magic",
"workflow_tag": "hair_magic_241128",
"template_id": 308552687706496,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_hairgrowth.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-28T08:34:06Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Grow lots of hair. Never be bald.",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"发量王者\",\"display_prompt\":\"长出迷人秀发,永无秃头困扰。\"}}",
"example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "COLORFUL Venom!",
"workflow_tag": "random_venom_241104",
"template_id": 304358279051648,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_colorfulvenom.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-04T15:39:54Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Transform into a [COLORFUL] Venom",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"毒液!(彩色盲盒版)\",\"display_prompt\":\"变身成为【彩色】毒液\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Who is Venom?",
"workflow_tag": "who_is_venom_241112",
"template_id": 305714097668480,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_whoisvenom.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-12T07:33:35Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Which one of you guys is Venom? ",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"测测谁是毒液?\",\"display_prompt\":\"两人之中,必有一毒,速速现出原形\"}}",
"example_list": "[{\"img_id\":111917190,\"img_url\":\"https://media.pixverse.ai/upload%2F6a6a0f6a-99be-4eac-83a1-9d265ca65823.png\"},{\"img_id\":111917753,\"img_url\":\"https://media.pixverse.ai/upload%2F079945d6-01aa-4688-9e9a-02e308c01db5.png\"},{\"img_id\":111917942,\"img_url\":\"https://media.pixverse.ai/upload%2F814307ed-4123-4f6b-a32e-4072b55378cb.png\"}]",
"qualities": [
"360p",
"540p"
]
},
{
"display_name": "Get a Venom buddy",
"workflow_tag": "baby_venom_241114",
"template_id": 306059795500352,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_venombuddy.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-14T06:26:53Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "Your Venom buddy appears and gives you a hug",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"召唤毒液兄弟\",\"display_prompt\":\"你的毒液兄弟回到你身边,并与你深情相拥\"}}",
"example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Wicked Shots",
"workflow_tag": "wicked_paintings_241028",
"template_id": 303788802773760,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_wickedshot.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-11-01T10:25:30Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "The [SUBJECT] in the picture smiles wickedly and starts firing",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"扫射一切\",\"display_prompt\":\"邪魅一笑,并掏出一把机关枪开始扫射\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Squish It",
"workflow_tag": "squish_it_241028",
"template_id": 302325299692608,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_squishit.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "A pair of hands appears and squishes the [OBJECT] as if it's slime",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"捏捏更解压\",\"display_prompt\":\"变成可以捏捏的软泥\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Lego Blast",
"workflow_tag": "lego_blast_241028",
"template_id": 302325299702848,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_legoblast.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "The [OBJECT] shatters into pieces of Legos",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"乐高大爆炸\",\"display_prompt\":\"爆炸并碎裂成一片片乐高积木\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Leggy Run",
"workflow_tag": "leggy_run_241028",
"template_id": 302325299711040,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_leggyrun.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "The [OBJECT] grows legs and runs away",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"全员腿精\",\"display_prompt\":\"长出了一双腿然后开始乱跑\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Monster Invades",
"workflow_tag": "monster_invasion_241028",
"template_id": 302325299682368,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_monster.gif",
"thumbnail_video_path": "",
"marker": "default",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "A monster suddenly appears in the [SCENE] and starts walking around",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"怪兽入侵\",\"display_prompt\":\"场景中突然出现了一只怪兽\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Wizard Hat",
"workflow_tag": "animal_wizard_241028",
"template_id": 302325299661888,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_wizardhat.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "The [SUBJECT] wears a magic wizard hat",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"戴上魔法帽\",\"display_prompt\":\"头顶出现了一顶可爱的魔法帽\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Zombie Hand",
"workflow_tag": "zombie_hand_241028",
"template_id": 302325299672128,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_weirdhand.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "A zombie hand appears in the [SCENE]",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"僵尸手出没\",\"display_prompt\":\"从图片中的场景中钻出一只僵尸的手\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
},
{
"display_name": "Zombie Mode",
"workflow_tag": "zombie_mode_241028",
"template_id": 302325299651648,
"thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_zombiemode.gif",
"thumbnail_video_path": "",
"marker": "hot",
"created_at": "2024-10-24T03:55:29Z",
"updated_at": "2024-12-25T10:19:28Z",
"display_prompt": "The [SUBJECT] suddenly transforms into a zombie.",
"i18n_json": "{\"zh-CN\":{\"display_name\":\"坏了,我变僵尸了\",\"display_prompt\":\"突然变成僵尸\"}}",
"example_list": "",
"qualities": [
"360p",
"540p",
"720p",
"1080p"
]
}
]

我们可以在上面选择一个 template_id 来生成视频,我们以302325299651648为示例生成视频,其他参数与基本使用类似,具体的参数如下图所示:

填写完毕之后自动生成了代码如下:

对应的 Python 代码:

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

url = "https://api.acedata.cloud/pixverse/videos"

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

payload = {
"action": "generate",
"prompt": "A group of people began to dance",
"template_id": 302325299651648,
"image_url": "https://cdn.acedata.cloud/n3r1mc.png"
}

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
{
"success": true,
"task_id": "cf127eee-d23d-44c9-945c-793e68f86720",
"trace_id": "aa7ed21d-8363-4eeb-a46a-a120e31b4fde",
"data": [
{
"id": 318162170958272,
"first_frame": "",
"video_width": 0,
"video_height": 0,
"prompt": "A group of people began to dance",
"model": "v3.5",
"quality": "360p",
"motion": "normal",
"video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
"template_id": 302325299651648,
"template_name": "Zombie Mode",
"style": "",
"aspect_ratio": "16:9",
"duration": 5,
"extended": 0,
"last_frame": "",
"seed": 0,
"asset_id": 0,
"asset_name": ""
}
]
}

可以看出,结果内容与是与视频模板特效一样的,这也就实现使用模板特效来生成视频的功能。

继续扩展视频生成功能

如果想对已经生成的Pixverse视频进行扩展生成的话,可以将参数 action 设置为 extend ,并且输入需要扩展生成视频的 ID,视频 ID 的获取是根据基本使用来获取,如下图所示:

这时候可以看到视频的 ID 为:

1
"id": 317989274748288

注意,这里的视频中 id 是生成后视频的 ID,如果你不知道如何生成视频,可以参考上文的基本使用来生成视频。

接下来我们要必须填歌词、风格自定义生成歌曲,就可以指定如下内容:

  • action:此次视频生成任务的行为,一般有普通生成 generate 和扩展视频 extend。
  • prompt:此次视频生成的提示词。
  • video_id:此次扩展视频任务的参考视频ID。

填写样例如下:

填写完毕之后自动生成了代码如下:

对应的 Python 代码:

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/pixverse/videos"

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

payload = {
"action": "extend",
"prompt": "A group of people began to dance",
"video_id": 317989274748288
}

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
{
"success": true,
"task_id": "38b6d70d-eea2-40da-9f8b-945df93e831b",
"trace_id": "b105bbb6-faf1-4d86-9c10-4b8a8e638d05",
"data": [
{
"id": 318162960027008,
"first_frame": "",
"video_width": 0,
"video_height": 0,
"prompt": "A group of people began to dance",
"model": "v3.5",
"quality": "360p",
"motion": "normal",
"video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
"template_id": 0,
"template_name": "",
"style": "",
"aspect_ratio": "16:9",
"duration": 5,
"extended": 1,
"last_frame": "",
"seed": 0,
"asset_id": 0,
"asset_name": ""
}
]
}

可以看出,结果内容与上文的是一致的,这也就实现视频的扩展生成功能。

自定义角色生成视频

如果想对根据一张图片角色来生成视频的话,需要额外输入根据图片创建的角色
ID字段 asset_id,字段 asset_id 的获取是使用 Pixverse Character API来获取,具体的结果如下图所示:

当生成角色ID之后就可以按照基本使用来生成视频了,这里以 asset_id= 318174747147968 为示例,下面是具体的参数:

点击运行后可以生成自定义角色的视频结果,具体的结果如下图所示:

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
{
"success": true,
"task_id": "d39994c7-53ba-4c3f-ae8f-44287c487d51",
"trace_id": "32da3212-2d4c-4302-87ef-01ecb903a92b",
"data": [
{
"id": 318175009783232,
"first_frame": "",
"video_width": 0,
"video_height": 0,
"prompt": "A group of people began to dance",
"model": "v3.5",
"quality": "360p",
"motion": "normal",
"video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
"template_id": 0,
"template_name": "",
"style": "",
"aspect_ratio": "16:9",
"duration": 5,
"extended": 0,
"last_frame": "",
"seed": 0,
"asset_id": 318174747147968,
"asset_name": "my-46169546-a9c0-4437-96ee-a9750bbd489f"
}
]
}

生成的结果与上文类似,这就完成了按照角色来生成视频的过程。

目前所支持的特效模板

模版id以及对应的效果:

模版id 效果
321958627120000 AI发对象咯
324641581197696 一起摇摆!
324641385496960 360°旋转微波炉
325367418993728 樱花乌托邦
325501134629952 北极熊出没!
315447659476032 不打不相识
324640938615168 万物皆可毛绒玩具
308621408717184 成为肌肉猛男
313358700761536 万物皆可变形金刚
316645675647872 雪茄大佬
321956810449792 奥斯卡影帝
323578865822784 性别转换器
303624424723200 爱的抱抱
313555098280384 换上比基尼
313649491716544 猛虎的抱抱
313649622731200 天使之翼
316826014376384 拥抱耶稣
315446315336768 爱的亲亲
322852853601344 万物皆可走红毯
304826314164992 绿巨人变身
315447659476032 黑悟空引擎
313359138372032 成为美少女战士
308552687706496 发量王者
307489548427968 疯狂猫女变身
304826126435072 小丑重生
304826374632192 蝙蝠侠归来
304358279051648 毒液!(彩色盲盒版)
304826054394624 钢铁侠变身
317013509917440 新年战裙
313358844899776 做自己的财神
313359048325568 蛇年的第一个贴贴
307489434436288 小丑女哈莉·奎茵变身
311521768592256 圣诞礼物盲盒
311521879229312 圣诞老人藏在哪?
312314911869312 圣诞战袍
306059795500352 召唤毒液兄弟
303788802773760 扫射一切
302325299702848 乐高大爆炸
302325299682368 怪兽入侵
302325299661888 戴上魔法帽
302325299651648 坏了,我变僵尸了
302325299672128 僵尸手出没

风格:

动作模式 效果
normal 普通模式
fast 性能模式

运镜

参数 效果
horizontal_left 水平向左
horizontal_right 水平向右
vertical_up 垂直向上
vertical_down 垂直向下
crane_up 上升镜头
hitchcock 希区柯克变焦
zoom_in 放大
zoom_out 缩小
quickly_zoom_in 快速推进
quickly_zoom_out 快速拉远
smooth_zoom_in 平滑推进
super_dolly_out 超级拉远
left_follow 左侧跟拍
right_follow 右侧跟拍
pan_left 左侧环弧
pan_right 右侧环弧
fix_bg 固定镜头
camera_rotation 镜头旋转
robo_arm 机械臂运动
whip_pan 快速摇镜

异步回调

由于 Pixverse 生成音乐的时间相对较长,大约需要 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/8dc4cd74-4f4c-49ab-95c8-fa503cca5534。

接下来,我们可以设置字段 callback_url 为上述 Webhook URL,同时填入 prompt,如图所示:

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

1
2
3
{
"task_id": "84acf7e2-66a7-407a-8295-f0cc7a58579b"
}

稍等片刻,我们可以在 https://webhook.site/8dc4cd74-4f4c-49ab-95c8-fa503cca5534 上观察到生成歌曲的结果,如图所示:

内容如下:

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
{
"success": true,
"task_id": "84acf7e2-66a7-407a-8295-f0cc7a58579b",
"trace_id": "a4b9b5d5-10fe-4a8e-8cd4-642056908fe8",
"data": [
{
"id": 318175621179584,
"first_frame": "",
"video_width": 0,
"video_height": 0,
"prompt": "quiver",
"model": "v3.5",
"quality": "360p",
"motion": "normal",
"video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
"template_id": 0,
"template_name": "",
"style": "",
"aspect_ratio": "16:9",
"duration": 5,
"extended": 0,
"last_frame": "",
"seed": 0,
"asset_id": 0,
"asset_name": ""
}
]
}

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

错误处理

如果发生错误,您将得到类似如下的错误信息:

1
2
3
4
5
6
7
8
9
{
"success": false,
"error": {
"code": "forbidden",
"message": "Song Description contained artist name: eminem"
},
"trace_id": "9bb7c2f4-3b7b-4965-b50a-f663874b1b6f",
"task_id": "9bb3a2a6-c438-436d-a9f3-fa466abc077c"
}

技术教程

这是一篇总览文章:把 AceData Cloud 提供的 10 个 MCP Server 一次性接到 Gemini CLI,让 Google 的开源终端 AI 工具在帮你写代码之余顺手生图、写歌、做视频、搜网页。

Gemini CLI 是 Google 官方推出的开源终端 AI 助手,由 Gemini 模型驱动,原生支持 MCP。

AceData Cloud 提供哪些 MCP Server?

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

MCP Server 领域 核心能力 远程 URL
Suno 🎵 音乐 文生歌、歌词、翻唱、续写、人声分离、Persona https://suno.mcp.acedata.cloud/mcp
Midjourney 🎨 绘画 文生图、混图、放大、Edit、生成视频 https://midjourney.mcp.acedata.cloud/mcp
Flux 🎨 绘画 6 个模型、Kontext 编辑、商用免版税 https://flux.mcp.acedata.cloud/mcp
Seedream 🎨 绘画 字节跳动模型,中文 prompt 理解最强 https://seedream.mcp.acedata.cloud/mcp
NanoBanana 🎨 绘画 Gemini 驱动、虚拟试衣、商品换景 https://nanobanana.mcp.acedata.cloud/mcp
Luma 🎬 视频 Dream Machine、首尾帧控制 https://luma.mcp.acedata.cloud/mcp
Veo 🎬 视频 Google 模型、原生音频、1080p 超分 https://veo.mcp.acedata.cloud/mcp
Seedance 🎬 视频 字节跳动、动作生成、配音 https://seedance.mcp.acedata.cloud/mcp
Serp 🔍 搜索 Google 搜索 6 种类型、多语言 https://serp.mcp.acedata.cloud/mcp
ShortURL 🔗 工具 长链转短链、批量、永久免费 https://shorturl.mcp.acedata.cloud/mcp

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


为什么 Gemini CLI + MCP

  • Google 官方支持,Gemini 模型免费额度大方
  • 通过 MCP 接入 AceData Cloud,Gemini CLI 同时获得 Google Veo、Anthropic 生态、字节跳动 Seedance 等多家能力
  • gemini mcp add 命令一键配置

第 1 步:获取 API Token

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

AceData Cloud 首页 Token

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

第 2 步:在 Gemini CLI 中添加 MCP

方式 A:CLI 一键添加(推荐)

1
2
3
4
5
6
7
8
9
10
gemini mcp add suno       --transport http https://suno.mcp.acedata.cloud/mcp       --header "Authorization: Bearer 你的Token"
gemini mcp add midjourney --transport http https://midjourney.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add flux --transport http https://flux.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add seedream --transport http https://seedream.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add nanobanana --transport http https://nanobanana.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add luma --transport http https://luma.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add veo --transport http https://veo.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add seedance --transport http https://seedance.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add serp --transport http https://serp.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"
gemini mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp --header "Authorization: Bearer 你的Token"

方式 B:直接编辑配置文件

~/.gemini/settings.json:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"mcpServers": {
"suno": { "httpUrl": "https://suno.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"midjourney": { "httpUrl": "https://midjourney.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"flux": { "httpUrl": "https://flux.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"seedream": { "httpUrl": "https://seedream.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"nanobanana": { "httpUrl": "https://nanobanana.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"luma": { "httpUrl": "https://luma.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"veo": { "httpUrl": "https://veo.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"seedance": { "httpUrl": "https://seedance.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"serp": { "httpUrl": "https://serp.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } },
"shorturl": { "httpUrl": "https://shorturl.mcp.acedata.cloud/mcp", "headers": { "Authorization": "Bearer 你的Token" } }
}
}

保存后下次启动 gemini 时所有 MCP Server 自动挂载。


第 3 步:试一试

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

例 1(写完 demo 项目顺手生 hero 图):

用 Seedream 生成一张「Gemini CLI 开发者工具」展示图,扁平插画风、亮色背景。

例 2(搜索 Google 资源):

用 Serp 的 google_search 搜 “Gemini CLI extensions” 前 3 条 GitHub 项目。

例 3(生成产品 demo 视频):

用 Veo 生成 5 秒视频:一只机器人猫在电脑前敲代码,屏幕显示 “gemini” 字样,1080p。


计费与额度

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

常见问题

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

Q:有没有更便宜的接入方式?
A:直接调用 REST API 比 MCP 更便宜(少一层封装),但失去 MCP 在 LLM 工具调用上的便利。

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

Q:支持自托管吗?
A:MCP Server 全部 开源在 GitHub,可自行部署。


相关链接

技术教程

一个完全挂着你自己品牌的 AI 站——聊天、绘图、音乐、视频都在里面

先说结论:你现在就能拥有一个和 studio.acedata.cloud 一样强的 AI 网站——聊天、生图、生音乐、生视频三十多项能力全都有——但它挂的是你的 Logo、你的站名、你的域名、你定的价。用户在上面注册、消费,全都和你有关。

而这一切,不用写一行代码、不用租服务器、不用对接任何一个模型。它不是让你去 clone 一份开源代码自己部署(那条路又累又难维护,主站升级你还得跟着重新构建)。它就是 Studio 里一个叫「自定义分站(白牌)」的功能——全部在 Studio 设置弹窗里点几下就配完了。

这篇我手把手带你把它跑起来:从建站、换品牌、绑域名,到定价、选能力、把访客归到你名下。全程真实截图、真实操作。


一、它到底是什么:不是”部署”,是”配置”

一句话讲清楚原理:它不是让你重新部署一份网站,而是主站根据访问进来的域名,动态加载”你的那套配置”。

1
2
3
4
5
6
7
你的域名 / 你的前缀.studio.acedata.cloud
│
▼
Studio 主站 + 你的品牌 / 定价 / 能力 / 归属配置
│
▼
共用平台的几十个模型、GPU 算力、支付、积分账本

这个设计有个特别爽的地方:主站升级,你的站自动跟着升级。 我们上了新模型、修了 bug、加了新功能,你什么都不用做,你的用户第二天打开就用上了。你永远不会卡在”又要拉代码、又要重构、又跑不起来”的泥潭里。

你拥有的是一层属于你自己的东西——品牌、域名、定价、用户归属;而底下那些又重又贵的东西——几十个模型的对接、算力、支付通道、风控、多语言——继续由平台扛着。


二、5 分钟建站:入口在 Studio 设置弹窗

用任意方式登录 studio.acedata.cloud(微信、Google、GitHub、邮箱都行),点右下角的齿轮打开设置。这个弹窗就是白牌的整个控制中心,左边一排导航,从上到下是:

General / API Key / Memory / Site Settings / Price / SEO / Distribution / Capabilities / Auth / Custom Domain / About

配一个属于你的站,主要用到其中这几栏:Site Settings(品牌)、Capabilities(能力)、Price(定价)、Auth(登录方式)、Custom Domain(域名)、Distribution(归属)。下面一栏一栏走。

一个先讲在前面的限制:每个账号目前最多建 5 个子站。对绝大多数人够用了——真要做大,一个做精比五个凑数强得多。


三、Site Settings:把它换成你的品牌

打开 Site Settings,这里是”用户第一眼看到的一切”。

Site Settings:站名、Logo、Favicon、主题色(#ff210c)、管理员、客服联系方式都在这一栏

一项一项改:

  • 站名(Title):浏览器标签页、页面标题到处都会显示它。别再叫 “Studio” 了,叫你自己的产品名,比如「灵感画室」「XX 智能助手」。尽量短、好念、和你的人群相关。
  • Logo:站点左上角那张脸。传一张你自己的,透明底 PNG 最稳。没有现成 Logo?就在你这个站里用 gpt-image-2 生一个——这正是白牌的乐趣:用它生成它自己的品牌素材。
  • Favicon:标签页那个小图标。别忽略——它虽小,但换没换过一眼能看出专不专业。
  • 主题色(Primary Color):调成你的品牌色(截图里这个站用的是 #ff210c)。一个主色改下来,整站的按钮、高亮、强调色全跟着变,观感立刻不一样。别贪多,一个主色就够。
  • 客服 / 联系方式:这一步很多人漏,但很关键——把默认客服换成你自己的微信/邮箱/客服群。想清楚这条链路:用户遇到问题找客服 → 找到的是你。这样你才真正接住了客户关系,而不是把他送回平台。

四、Capabilities:挑你要卖的能力,还能给每个 app 改名换图标

打开 Capabilities,这里列着 Studio 全部三十多项 AI 能力——聊天、生图、生音乐、生视频、各种模型——每一项都能单独开 / 关。

Capabilities:30+ 项能力,每项一个开关,右侧还能 Customize app

我的建议是:别全开,做减法。

  • 做”给设计师的 AI 画图站”,就重点留生图,把音乐、视频关掉,界面清爽、定位清晰;
  • 做”给自媒体的一站式创作台”,就聊天 + 生图 + 生视频都留着。

用户面对一个”什么都能干、但不知道从哪开始”的站,反而会走。做减法,比堆功能更显专业。

每一项能力右边还有个 Customize app——点进去可以给这个 app 单独改名字、换图标:

Customize app:给单个能力自定义名称和图标(PNG/JPEG/WebP,方形裁剪)

比如把 “Midjourney” 在你站里叫成「AI 绘画」、配上你自己的图标;把 “Suno” 叫成「一键写歌」。改完之后,用户在你站里看到的就是你命名的一套能力,而不是一堆认不出来的第三方名字。


五、Price:站点统一加价 0–500%,也能单服务覆盖

打开 Price。这里先把白牌到底怎么赚钱这件事讲对,别搞成”吃差价”的误会。

Price:站点统一加价(这里 200%)、关闭充值开关、逐服务覆盖表(可见性/加价/显示名/排序)

机制是这样的:

  • 平台按官方价给每笔订单计价;
  • 你可以设一个加价比例(范围 0%–500%,也就是最高卖到官方价的 6 倍),用户实际看到、支付的是加价之后的成交额;
  • 但加价本身不是直接进你口袋的”差价”——它抬高的是这笔订单的成交额,也就是后面分销返佣的计算基数;
  • 你真正拿到手的钱,是平台按分销返佣比例乘在这个成交额上返给你的那一份。

一句话:加价负责把蛋糕做大,返佣负责决定你切多大一块。 加价越高,返佣基数越大,同一个比例下你分到的越多。

加价有两种粒度:

  • 整站统一比例:给整个子站设一个加价,所有能力都按它加。最省事,适合起步。
  • 单服务覆盖:在下方那张表里给某个服务(比如生视频)单独设加价、单独设可见性和显示名,覆盖整站默认值。适合”不同能力想走不同溢价”的精细化玩法。

这一栏还有个关闭充值的开关——如果你不想让用户在你站里自助充值(比如你想走线下对公、或统一由你代充),可以关掉。


六、Auth:选客户能用哪些登录方式,还能换短信签名

打开 Auth,这里决定”用户在你站上怎么登录”。

Auth:勾选启用的登录方式(Email/Google/GitHub/Apple/Phone/WeChat)、默认方式、登录形态、自定义短信签名

你可以:

  • 勾选启用哪些登录方式:Email、Google、GitHub、Apple、手机号、微信——只留你目标人群会用的。做国内自媒体的,留微信 + 手机号;做海外的,留 Google + Apple + Email。
  • 设默认登录方式和登录形态(内嵌弹窗等)。
  • 自定义短信签名:手机号登录发的验证码短信,签名可以换成你自己的名字——用户收到的验证码前面挂的是你的品牌,而不是平台的。这一步对”隐藏平台痕迹”很加分。

七、Custom Domain:绑你自己的域名,HTTPS 全自动

打开 Custom Domain。默认你的站地址是 你的前缀.studio.acedata.cloud,一看就是”挂在别人下面”的。绑上你自己的域名(比如 ai.yourbrand.com),它才真正像个独立产品。

Custom Domain:一条 CNAME 绑定自己的域名,Let's Encrypt 免费 HTTPS 自动签发+续期,状态 Active

这个功能现在是完整可用的(早期版本还不支持,现在已经上线)。你只需要两样东西:一个你拥有的域名 + 能进它的 DNS 后台。步骤:

  1. 在这一栏填入你要绑的完整域名,例如 ai.yourbrand.com;页面会告诉你需要 CNAME 到哪个目标地址(以页面实际显示为准)。
  2. 去你域名注册商的 DNS 控制台,加一条 CNAME,把 ai(或你想要的子域)指向平台给你的目标地址。
  3. 等 DNS 生效(几分钟到几十分钟),平台会用 Let’s Encrypt 自动帮你签发 HTTPS 证书,并自动续期——你完全不用碰证书、不用管运维。

生效后用 https://ai.yourbrand.com 打开,看到小锁 + 你的品牌,就绑成功了。截图里 studio.zhishuyun.com 那行状态是 Active,就是一个绑好的真实例子。

用子域名(ai.yourbrand.com)最省心。根域名裸域(yourbrand.com)部分 DNS 商不支持 CNAME,需要用 ALIAS/ANAME 或 CNAME 拉平(Cloudflare、DNSPod 都支持)。


八、Distribution:让每个注册用户自动归到你名下

这是最容易被忽略、但最值钱的一栏。你站建得再漂亮,如果用户注册后没绑定到你名下,那加价抬高的成交额、阶梯算出的比例,都跟你没关系。

Distribution:设置默认归属(Default / Forced Inviter ID),所有从这个站注册的用户自动绑到你名下

在 Distribution 里设好默认归属 Inviter ID(填你自己的用户 ID)之后:凡是从这个子站进来、注册的新用户,都自动绑定到你名下,不用你手动给每个人拼邀请链接。

它的底层机制和平台通用的邀请归属一致:访客进站后浏览器记下一个 INVITER_ID,保存 7 天;只要访客在这 7 天窗口内完成注册,就绑成你的下级。绑定一旦建立,关系长期有效(7 天只是”点链接到注册”这段窗口,不是绑定 7 天就失效)。

如果你想手动拼一条带你标识的通用链接发出去,格式是:

1
https://platform.acedata.cloud/?inviter=<你的用户ID>

顺手把 SEO 那一栏也填了(站点描述 + 关键词),你的站要靠搜索引擎自然流量获客时用得上。


九、说清楚你到底怎么赚钱(诚实版,不画饼)

白牌的收益只有一个引擎:分销返佣;加价和归属是把它顶到最大的两个杠杆。别把它理解成”两笔独立收入”。

杠杆一 · 加价(Price)——决定”蛋糕多大”。
你在官方价上加 0–500%,用户按加价后的成交额付款。这多出来的钱不是直接归你,而是把这笔订单的返佣计算基数抬高了。

杠杆二 · 分销返佣——决定”你切多大一块”。
在你站上注册的用户绑定到你名下(靠上面的 Distribution),他们每一笔真实消费都按平台的 13 级阶梯返给你。比例以你名下所有客户的累计消费额决定档位,只升不降:

等级 累计客户消费(USD) 返佣比例
L1 $0(起步) 10%
L2 $150 12%
L3 $700 13%
L4 $1,400 14%
L5 $3,000 15%
L6 $7,000 16%
L7 $14,000 17%
L8 $28,000 18%
L9 $50,000 19%
L10 $100,000 20%
L11 $250,000 21%
L12 $500,000 22%
L13 $1,000,000 24%

如果你自己也是被别人邀请来的(头上有上级),这份返佣按 80 / 20 拆:你(直接邀请人)拿 比例 × 0.8,你的上级拿 比例 × 0.2;没有上级,那 20% 不产生,你拿 比例 × 0.8。

举个只讲机制的例子(算法演示,非收入承诺): 你在 L1(10%),加价设 100%。某项能力官方价 $1,用户就按 $2 成交。这笔订单的返佣基数是 $2,你实得 $2 × 10% × 0.8 = $0.16(你有上级的情况)。同样这笔,如果你加价设 0,基数是 $1,你实得 $1 × 10% × 0.8 = $0.08。看,加价把基数翻倍,返佣也跟着翻倍——这就是加价这个杠杆的作用。 等你累计客户消费爬到 L10(20%),同一笔又会再翻一倍。

一个如实提醒:返佣入账后有约 3 天的确认(pending)期,过了才可提现——这是对齐退款/风控窗口的正常节奏,不是”随时秒提”。别对客户或自己承诺”立刻到账”。


十、现在就去开一个

说这么多,不如动手。整条链路复盘一遍:

1
2
3
4
5
6
7
建站(5 分钟)
→ Site Settings 换品牌(Logo/站名/主题色/客服)
→ Capabilities 挑能力 + 给每个 app 改名换图标
→ Price 设加价(0–500%)
→ Auth 选登录方式 + 换短信签名
→ Custom Domain 绑你自己的域名(自动 HTTPS)
→ Distribution 让访客注册即归你名下

六步走完,你就有了一个完全属于你自己、能持续产生返佣的 AI 站。

打开 studio.acedata.cloud,点右下角齿轮,开始配你的第一个子站吧。AI 这波浪潮里最好的位置,不是站在岸上看,而是手里握着一个自己的东西——白牌就是那个门槛最低、又真的属于你的”自己的东西”。

站建好之后,下一步是给它导流。怎么用 AI 一次写作、把带你链接的内容铺到知乎、掘金、小红书、CSDN、B 站、Medium 等十几个平台——那是《Connector 内容营销实战》整个系列要讲的。站是”接住流量的容器”,Connector 是”制造流量的发动机”,两个配起来用,你才真正跑起来了。

产品推广

📘 Overview:Claude Desktop MCP Overview →

可灵(Kling)是快手出品的高质量视频生成模型,支持文生视频、图生视频、视频扩展,画面细腻、动作连贯。

配置 Claude Desktop

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

  1. 打开 https://claude.ai/customize/connectors(或 Claude Desktop 的 Settings → Connectors)。
  2. 点击 Add custom connector,Name 填 kling 或 Kling,URL 填:

    1
    https://kling.mcp.acedata.cloud/mcp
  3. 首次连接会跳转到 AceData Cloud 完成 OAuth 授权,确认后即可在对话中调用。

Kling 能做什么?

可灵(Kling)是快手出品的高质量视频生成模型,支持文生视频、图生视频、视频扩展,画面细腻、动作连贯。

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

  • 用 kling-v3 生成一段 5 秒的视频:日落时分的海边公路,镜头从车窗向前推

  • 用这张图(链接 xxx)生成 image2video,让画面里的人物缓慢转身

  • 把刚才那段视频再扩展 5 秒,让剧情自然衔接

注意事项

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

工具

工具 说明
kling_generate_video 通过文本 / 图片生成视频(kling-v1 / v1-6 / v2-master / v2-1-master / v2-5-turbo / v2-6 / v3 / v3-omni)
kling_extend_video 对已有视频按提示词继续延伸

相关链接

API 开发教程

Cherry Studio 是一款开源的多模型 AI 桌面客户端,支持 Windows、macOS、Linux。它「自定义服务商 + 自定义 API 地址」的能力,可以让你把任意 OpenAI 兼容的网关(包括 Ace Data Cloud)接入到同一个客户端里。

借助 Ace Data Cloud,你只需要一份 API Token,就能在 Cherry Studio 中使用:

  • 对话模型:Claude、GPT(含 gpt-4o-image 等对话式画图模型)、Gemini、Grok、Kimi、GLM、DeepSeek。
  • 专用图像模型:通过命令行 / SDK 直接调用 gpt-image-2、gpt-image-1.5、nano-banana-pro 等(这部分 Cherry Studio 的 UI 暂时无法直接接入,本文末尾给出原生调用方式)。

本文档严格按照 Cherry Studio 官方文档 中描述的 UI 字段,介绍如何在 Cherry Studio 中接入 Ace Data Cloud。

申请流程

要在 Cherry Studio 中接入 Ace Data Cloud,首先到 Ace Data Cloud 控制台,获取您的 API Token,留作备用。

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

在首次申请时会有免费额度赠送,可以免费体验 Ace Data Cloud 的模型服务。

关键背景

要正确配置 Cherry Studio,请先理解两件事——它们都来自 Cherry Studio 官方文档和 Ace Data Cloud 的实际接口结构。

1. Cherry Studio 的「API 地址」拼接规则

Cherry Studio 在 OpenAI 类型供应商中对 API 地址 字段有明确约定(来源:Cherry Studio 官方文档 — 模型服务设置):

  • 不以 # 结尾:Cherry Studio 会自动在末尾拼接 /v1/chat/completions。比如你填 https://api.example.com,实际请求的就是 https://api.example.com/v1/chat/completions。
  • 以 # 结尾:Cherry Studio 把 # 之前的部分作为完整 URL 直接使用,不再做任何拼接。这是指向非默认路径(例如 /openai/chat/completions、/gemini/chat/completions)的关键。

2. Ace Data Cloud 一个模型家族一个入口

Ace Data Cloud 为每个上游模型家族都提供了独立的 OpenAI 兼容入口(如 GPT 走 /openai、Gemini 走 /gemini)。此外 /v1/chat/completions 是一个通用入口,可路由任意家族的 model ID(不限于 Claude)。下面按家族列出各自入口,方便分组管理。

模型家族 Ace Data Cloud 接口 部分可用模型
Claude https://api.acedata.cloud/v1/chat/completions claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5-20251001
GPT (OpenAI) https://api.acedata.cloud/openai/chat/completions gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.2、gpt-5-mini、gpt-4o、gpt-4o-image、o3
Gemini https://api.acedata.cloud/gemini/chat/completions gemini-3.1-pro、gemini-3.0-pro、gemini-3.5-flash、gemini-2.5-pro
Grok https://api.acedata.cloud/grok/chat/completions grok-4、grok-3
Kimi https://api.acedata.cloud/kimi/chat/completions kimi-k3、kimi-k2.6、kimi-k2.5
GLM https://api.acedata.cloud/glm/chat/completions glm-5.3、glm-5.2、glm-5.1、glm-4.7、glm-4.6
DeepSeek https://api.acedata.cloud/deepseek/chat/completions deepseek-r1、deepseek-v3、deepseek-v4-pro、deepseek-v4-flash

Claude 的入口刚好就是 Cherry Studio 的默认路径 /v1/chat/completions,所以 Claude 不需要加 #;其它家族都必须使用带 # 的完整 URL。完整模型清单请以 Ace Data Cloud 控制台 中各服务的 API 文档为准。

因此在 Cherry Studio 中,你可以为每个模型家族分别建一条供应商配置;如果嫌麻烦,也可以只建一条指向 /v1/chat/completions(结尾不加 #)的供应商,把各家族的 model ID 都加进去——该通用入口对所有家族都有效。

通用步骤:在 Cherry Studio 中添加自定义服务商

下面是 Cherry Studio 自定义服务商的通用流程,后面所有家族都按这个步骤来,只是填的「API 地址」和模型 ID 不同。

  1. 在 Cherry Studio 左侧导航栏中点击 设置(齿轮图标),选择 模型服务 选项卡。
  2. 在已有服务商列表下方点击 + 添加 按钮,打开 「添加提供商」 弹窗。
  3. 在弹窗中填:
    • 提供商名称:易于识别的名字,例如 Ace Data Cloud - Claude。
    • 提供商类型:从下拉里选 OpenAI(Cherry Studio 自定义服务商支持 OpenAI / Gemini / Anthropic / Azure OpenAI 四种类型)。
  4. 点击「添加」保存。
  5. 在服务商列表中找到刚添加的项,进入详情页:
    • 启用开关(右上角 / 列表右侧):必须打开,否则模型不会出现在对话选择器里。
    • API 密钥:粘贴 Ace Data Cloud 的 API Token;可点旁边的 检查 按钮校验密钥。
    • API 地址:填本文给出的对应家族 URL(除 Claude 外都以 # 结尾)。
    • 模型管理:点击 + 添加 按钮,手动输入要使用的模型 ID(必须与本文档或 Ace Data Cloud 文档中给出的 ID 大小写完全一致)。

下面以每个家族为例。

配置 Claude

  • 提供商类型:OpenAI
  • API 密钥:Ace Data Cloud Token
  • API 地址:

    1
    https://api.acedata.cloud

    不要加 #。Cherry Studio 会自动拼接 /v1/chat/completions,这正是 Ace Data Cloud 中 Claude 服务的入口。

  • 添加的模型 ID(示例):claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5-20251001

完整模型列表请参考 Claude AI 服务文档。

配置 GPT / Gemini / Grok / Kimi / GLM / DeepSeek

非 Claude 家族的「API 地址」都必须以 # 结尾。以 GPT 为例:

  • 提供商类型:OpenAI
  • API 密钥:同上
  • API 地址:

    1
    https://api.acedata.cloud/openai/chat/completions#
  • 添加的模型 ID(示例):gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.2、gpt-5-mini、gpt-4o、gpt-4o-image、o3

其余家族同理,只需把 API 地址替换为:

  • Gemini:https://api.acedata.cloud/gemini/chat/completions#
  • Grok:https://api.acedata.cloud/grok/chat/completions#
  • Kimi:https://api.acedata.cloud/kimi/chat/completions#
  • GLM:https://api.acedata.cloud/glm/chat/completions#
  • DeepSeek:https://api.acedata.cloud/deepseek/chat/completions#

每条供应商配置只需要添加对应家族的模型 ID。同一份 API Token 可以在所有供应商中复用,额度也是共享的。

在 Cherry Studio 的对话中生成图片:使用 gpt-4o-image

Cherry Studio 的「绘画」面板目前只支持 DMXAPI、TokenFlux、AiHubMix、硅基流动 四个内置供应商 的绘画模型,无法添加自定义画图服务商。同时它的 OpenAI 自定义供应商发送的是 chat-completion 形态请求,无法对接 Ace Data Cloud 的 /openai/images/generations 这种 Images-API 形态接口。

不过 Ace Data Cloud 的 gpt-4o-image 是一个 chat-completion 形态的图像模型——它接受标准的 messages[] 输入,把生成的图片以 ![](URL) 的 Markdown 形式放在 choices[0].message.content 里返回,因此可以直接通过 Cherry Studio 的对话面板使用。

配置方式:

  1. 复用上文的 「配置 GPT (OpenAI)」 供应商(API 地址 https://api.acedata.cloud/openai/chat/completions#)。
  2. 在该供应商下「+ 添加」模型 gpt-4o-image。
  3. 新建对话,在模型选择器中切到 gpt-4o-image,直接输入提示词即可。Cherry Studio 会按 Markdown 渲染响应里的图片 URL。

如果你希望让模型在「一张已有图片」的基础上修改,可以在对话框里附带图片(Cherry Studio 会以 image_url 形态发送,与 OpenAI 多模态消息一致)。如果对话框没有图片上传按钮,请到「模型管理」中为 gpt-4o-image 打开「视觉」能力开关——Cherry Studio 仅在模型被标记具备视觉能力时,才会显示图片上传入口。

完整请求/响应示例请参考 OpenAI Chat Completion API 文档的「GPT-4o 绘图模型」章节。

进阶:直接调用 gpt-image-2 / nano-banana-pro 等专用图像模型

gpt-image-2、gpt-image-1.5、gpt-image-1、dall-e-3、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana 这些是专用 Images-API 形态模型,请求体是 {model, prompt, size, ...} 而不是 {model, messages: [...]}。它们只能通过 Ace Data Cloud 的 /openai/images/generations 接口调用,不能配置进 Cherry Studio——只能用 curl / SDK / 后端服务直接对接。

接口地址:

1
https://api.acedata.cloud/openai/images/generations

可用 model(与 Ace Data Cloud OpenAI 图像服务的 model 枚举完全一致):gpt-image-2、gpt-image-1.5、gpt-image-1、dall-e-3、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana。

size 字段约束(来自 OpenAI 图像生成接口的官方说明):可以是任意 WIDTHxHEIGHT 字符串,但需要满足宽高均为 16 的倍数、长边 ≤ 3840、总像素 ≤ 8,294,400。文档中给出的预设值如下:

比例 1K 2K 4K
1:1 1024x1024 2048x2048 2880x2880
4:3 1536x1024 2048x1536 3264x2448
3:4 1024x1536 1536x2048 2448x3264
16:9 1792x1024 2048x1152 3840x2160
9:16 1024x1792 1152x2048 2160x3840

注意事项:

  • 计费按张数固定,与 size 无关。
  • gpt-image-1 / gpt-image-1.5 / gpt-image-2、nano-banana / nano-banana-2-lite / nano-banana-2 / nano-banana-pro 家族不支持 n > 1:即使传入更大的 n,也只会返回 1 张图、只计 1 张费用。如需多张候选,请并发发送多次请求。
  • 长耗时任务可以在请求体里传 callback_url,由 Ace Data Cloud 在出图后回调通知,避免占用客户端的等待连接。

curl 示例

以 gpt-image-2 生成一张 1:1 的 1K 图片:

1
2
3
4
5
6
7
8
curl https://api.acedata.cloud/openai/images/generations \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A vintage travel poster of the Amalfi Coast, art-deco style, bold typography reads AMALFI",
"size": "1024x1024"
}'

响应的 data[0].url 即为生成图片地址。完整字段说明(包括图像编辑 /openai/images/edits 的 image / mask 等参数)请参考:

为什么在 Cherry Studio 中使用 Ace Data Cloud

一份 Token 接入多家对话模型

Cherry Studio 原生支持的服务商虽多,但每家都需要自行注册、申请密钥、各自计费。通过 Ace Data Cloud,你只需要一份 API Token,就能在同一份额度下使用 Claude、GPT、Gemini、Grok、Kimi、GLM、DeepSeek 等模型,以及对话式画图模型 gpt-4o-image。

统一额度与扣费明细

所有请求按实际 Token / 张数计费,统一在 Ace Data Cloud 控制台 - 使用历史 查看;应用列表 中可以实时查看剩余额度。新用户首次申请有免费额度赠送。

国内可直连

Ace Data Cloud 在境内提供接入节点,无需自建代理即可在中国大陆访问 OpenAI / Anthropic / Gemini 等模型。

限制与注意事项

  • 每个模型家族需要独立的供应商配置:Claude 用默认拼接,其它家族必须带 # 并指向各自路径。把 gpt-5.5 发到 /v1/chat/completions 不会被识别。
  • 末尾 # 不可省略:所有指向 /openai/...、/gemini/...、/grok/...、/kimi/...、/glm/...、/deepseek/... 的供应商,API 地址必须以 # 结尾,否则 Cherry Studio 会强行追加 /v1/chat/completions。
  • 保存后务必打开启用开关:Cherry Studio 官方文档明确提醒「配置成功后务必打开右上角的开关,否则该服务商仍处于未启用状态」。
  • Cherry Studio 不能直连专用 Images API 模型:gpt-image-2 / nano-banana-pro / dall-e-3 等只能通过 curl / SDK 直接调用 /openai/images/generations。需要在 Cherry Studio 对话里画图,请使用 chat-completion 形态的 gpt-4o-image。
  • n > 1 不支持:gpt-image-*、nano-banana* 家族单次请求只返回 1 张图。

常见问题

提示 token_mismatched 或 invalid_token

请确认在「API 密钥」字段中粘贴的是 Ace Data Cloud 的 API Token,并且 Token 在 控制台 中仍处于可用状态、所属应用的余额充足。

提示模型不存在 / api_not_implemented / 404

绝大多数情况是把模型发到了不对的入口(例如把 gpt-5.5 发到了 Claude 入口),或者非 Claude 供应商的 API 地址末尾漏掉了 #。请按本文「关键背景」中的对照表为每个家族单独建供应商。

模型已经添加,但在对话选择器里看不到

请检查目标供应商「右上角的启用开关」是否打开。Cherry Studio 在供应商未启用时不会把它的模型加入对话选择器。

想在 Cherry Studio 里用 gpt-image-2

Cherry Studio 的「绘画」面板和 OpenAI 自定义供应商目前都无法对接 Ace Data Cloud 的 /openai/images/generations。请使用 gpt-4o-image(对话式画图,可在 Cherry Studio 对话中直接使用),或者用 curl / SDK 在 Cherry Studio 之外直接调用专用 Images API。

如何查看剩余额度

登录 Ace Data Cloud 控制台,即可查看当前账户的剩余额度和使用历史。

了解更多

API 开发教程

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

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

申请流程

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

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

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

📘 完整文档:Veo Videos Generation API →

请求示例

Veo Tasks API 可以用于查询 Veo Videos Generation API 的结果。关于怎样使用 Veo Videos Generation API,请参考文档 Veo Videos Generation API 。

我们以 Veo Videos Generation API 服务返回的任务ID一个为例,演示如何使用该 API。假设我们有一个任务ID:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,接下来演示如何通过传入一个任务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/veo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"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/veo/tasks"

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

payload = {
"id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"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
{
"_id": "68834c16550a4144a5112589",
"id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
"application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
"created_at": 1753435158.509,
"started_at": 1753435158.569,
"finished_at": 1753435250.969,
"elapsed": 92.4,
"credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
"request": {
"callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
"action": "text2video",
"model": "veo2-fast",
"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."
},
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"type": "videos",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"data": [
{
"id": "2f43ceed37944b4d836e1a1899dad0a1",
"video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
"created_at": "2025-07-25 17:19:20",
"complete_at": "2025-07-25 17:21:45",
"state": "succeeded"
}
]
}
}

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

  • id,生成此视频任务的 ID,用于唯一标识此次视频生成任务。
  • request,查询视频任务中的请求信息。
  • response,查询视频任务中的返回信息。
  • created_at,任务创建时间,Unix 时间戳(秒,浮点)。
  • started_at,任务开始执行时间,Unix 时间戳(秒,浮点)。
  • finished_at,任务完成时间,Unix 时间戳(秒,浮点)。任务未完成时不返回该字段。
  • elapsed,任务执行耗时,单位为秒(浮点,保留 3 位小数)。任务未完成时不返回该字段。

批量查询操作

这是是针对多个任务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/veo/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
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
{
"items": [
{
"_id": "68834c16550a4144a5112589",
"id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
"application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
"created_at": 1753435158.509,
"started_at": 1753435158.569,
"finished_at": 1753435250.969,
"elapsed": 92.4,
"credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
"request": {
"callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
"action": "text2video",
"model": "veo2-fast",
"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."
},
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"type": "videos",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"data": [
{
"id": "2f43ceed37944b4d836e1a1899dad0a1",
"video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
"created_at": "2025-07-25 17:19:20",
"complete_at": "2025-07-25 17:21:45",
"state": "succeeded"
}
]
}
},
{
"_id": "68834c16550a4144a5112589",
"id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
"application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
"created_at": 1753435158.509,
"started_at": 1753435158.569,
"finished_at": 1753435250.969,
"elapsed": 92.4,
"credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
"request": {
"callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
"action": "text2video",
"model": "veo2-fast",
"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."
},
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"type": "videos",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
"trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
"data": [
{
"id": "2f43ceed37944b4d836e1a1899dad0a1",
"video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
"created_at": "2025-07-25 17:19:20",
"complete_at": "2025-07-25 17:21:45",
"state": "succeeded"
}
]
}
}
],
"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"
}

结论

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

API 开发教程

Localization Translate API 的主要功能是通过输入需要翻译的文本来获取翻译后的文本,同时翻译后的语言可以自定义,并且翻译结果可以采用 json , markdown 俩种主流的方法来输出。

本文档将详细介绍 Translate API 的对接说明,帮助您轻松集成并充分利用该 API 的强大功能。通过 Translate API ,您可以轻松实现将输入的文本翻译为特定语言,并且支持特定的方式来输出翻译结果。

申请流程

要使用 Localization Translate API,首先到 Ace Data Cloud 控制台 获取您的 API Token,留作备用。

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

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

📘 完整文档:Localization Translate API →

请求示例

我们以一个英文输入为例,演示如何使用该 API。假设英文描述词为:# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.,接下来演示如何上传英文描述词并获取中文的翻译结果,同时以 markdown 的形式展示出来。

设置请求头和请求体

Request Headers 包括:

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

Request Body 包括:

  • input:上传的所需翻译的文本。
  • locale:自定义翻译的语言。
  • extension:自定义翻译结果的展示形式。
  • model:翻译采用的大模型,默认是 gpt-3.5。

设置如下图所示:

代码示例

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

部分代码示例如下:

CURL

1
2
3
4
5
6
7
8
9
curl -X POST 'https://api.acedata.cloud/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
"locale": "zh-CN",
"extension": "md"
}'

Python

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/localization/translate"

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

payload = {
"input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
"locale": "zh-CN",
"extension": "md"
}

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

响应示例

请求成功后,API 将返回此处翻译任务的结果信息。例如:

1
2
3
4
5
6
7
8
9
{
"data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
"usage": {
"prompt_tokens": 172,
"completion_tokens": 25
},
"model": "gpt-3.5-turbo-16k",
"locale": "zh-CN"
}

可以看到,结果中有一个 data 字段,里面包含了翻译后的中文,同时采用了 markdown 的形式返回,其它信息如下所示:

  • data,此处翻译任务的结果。
  • model,此处翻译任务采用的大语言模型。
  • locale,此处翻译任务的翻译语言类型。

错误处理

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

结论

通过本文档,您已经了解了如何使用 Localization Translate API 轻松实现将输入的文本翻译为特定语言,并且支持特定的方式来输出翻译结果。希望本文档能帮助您更好地对接和使用该 API。如有任何问题,请随时联系我们的技术支持团队。

技术教程

本页已合并到新版分步教程,请从 Studio 白牌从 0 到 1 建站 开始。

新版教程按正式开放标准拆为四篇:创建子站、品牌与登录、能力与定价、自定义域名与验收。旧链接暂时保留,避免历史收藏失效。