ARK SDK 兼容
把已有 Volcengine Ark seedance 客户端切到 XRToken 只需改 base URL 和 API key
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
如果你之前已经用官方 Volcengine Ark SDK 接入了 seedance 视频生成，可以只改两行配置把流量切到 XRToken：
- base URL：
https://ark.cn-beijing.volces.com/api/v3→https://api.xrtoken.net/v1（海外版用https://api.xrtoken.ai/v1） - API Key：把原本的 ARK_API_KEY 换成 XRToken 的
tr-开头密钥
请求体、响应体、轮询 URL 拼接方式全部和官方一致。
兼容范围
| 官方 ARK 路径 | XRToken 别名 | 是否 SDK 直接可用 |
|---|---|---|
POST /contents/generations/tasks | POST /v1/contents/generations/tasks | ✅ |
GET /contents/generations/tasks/{id} | GET /v1/contents/generations/tasks/{id} | ✅ |
DELETE /contents/generations/tasks/{id} | DELETE /v1/contents/generations/tasks/{id} | ✅ |
ARK 路径返回的 id 字段直接是上游 seedance 任务 ID（与官方一致），后续轮询 / 取消用同一个 id 即可。
Python SDK 示例
from volcengine.maas.v3 import MaasService, Tasks
# 改成 XRToken 的 base URL + API key，其他不动
client = MaasService("https://api.xrtoken.net/v1", "cn-beijing")
client.set_ak_sk("", "") # 不需要，下面改用 Bearer
client.set_token("tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
resp = client.create_task({
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "一只猫咪在草地上奔跑"}
],
})
print(resp["id"])不兼容的部分
素材库 / 真人活体接口 暂时不能直接 SDK drop-in。原因：
- 官方走的是 Volcengine Open API（
https://open.volcengineapi.com/?Action=...） - 鉴权用 V4 SigV4 算签名，需要 AK + SK
- 我们这边没法验你的 AK/SK，必须切到 Bearer 鉴权
但字段层面已经完全兼容：
| 官方 Action | XRToken 路径 | 鉴权 | 字段对应 |
|---|---|---|---|
Action=CreateAssetGroup | POST /v1/asset-groups | Bearer | 完全一致 |
Action=ListAssetGroups | GET /v1/asset-groups | Bearer | 完全一致 |
Action=CreateAsset | POST /v1/assets | Bearer | 完全一致 |
Action=DeleteAsset | DELETE /v1/assets/{id} | Bearer | 完全一致 |
Action=CreateVisualValidateSession | POST /v1/asset-groups/validate-session | Bearer | 完全一致 |
把签名调用换成 Authorization: Bearer tr-xxx、把 query string Action= 换成对应的 REST 路径即可，请求 / 响应 body 一字不改。
跨区域
CN 站点和海外站点都开放 ARK 别名。两边互相独立，按用户账号所属区域选 base URL：
- 国内：
https://api.xrtoken.net/v1 - 海外：
https://api.xrtoken.ai/v1