01
统一接口
所有模型共用同一套任务接口,换模型只改 model 字段。
- 同一个端点
- 同一套请求结构
- 同一套响应结构
- 同一套回调
1 个 Key
调用全部已接入模型
100%
任务失败退回全部 credits
2 分钟
一次回调兜底扫描
30 天
结果文件保留期
为什么靠得住
接入、计费、交付都在网关层处理好,你的代码只需要关心生成结果。
01
所有模型共用同一套任务接口,换模型只改 model 字段。
02
提交时预扣,任务结束时结算,每一笔变动都记在流水里。
03
从提交到交付,最容易出问题的环节都由网关兜住。
模型
1 credit = $0.005。每个模型单价公开,按实际用量扣费。
seedance-2.0
字节跳动的视频生成模型,支持文生视频与首尾帧图生视频,时长 4–15 秒。
720p 文生视频
33credits/秒
5 秒视频约 $0.825
seedance-2.0-fast
快速版本,请求结构与标准版相同。
720p 文生视频
33credits/秒
5 秒视频约 $0.825
图像、视频等更多生成模型正在陆续接入,沿用同一套接口,你的集成代码不需要改。
视频模型目前开放 720p。任务失败全额退回。
快速接入
所有模型共用一套接口,换模型只改一个字段。
curl -X POST https://api.xbaiapi.com/api/v1/jobs/createTask \
-H "Authorization: Bearer xb-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"input": {
"prompt": "a cat stretching on a sunlit windowsill",
"duration": 5
}
}'import os
import requests
resp = requests.post(
"https://api.xbaiapi.com/api/v1/jobs/createTask",
headers={"Authorization": f"Bearer {os.environ['XBAPI_KEY']}"},
json={
"model": "seedance-2.0",
"input": {
"prompt": "a cat stretching on a sunlit windowsill",
"duration": 5,
},
},
)
print(resp.json()["data"]["taskId"])const res = await fetch(
"https://api.xbaiapi.com/api/v1/jobs/createTask",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.XBAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.0",
input: {
prompt: "a cat stretching on a sunlit windowsill",
duration: 5,
},
}),
},
);
const { data } = await res.json();
console.log(data.taskId);细节
模型供应商出问题时最耗时间的那些环节。
任务、查询、回调对所有模型都一样,新模型上线即可直接调用。
每个模型的单价公开可查,按实际用量扣费,1 credit = $0.005。
所有产物都转存到我们自己的对象存储,保留 30 天,上游临时链接失效后仍可访问。
提交时预扣,任务一失败就全额退回。你不会为没拿到的结果付钱。
你的接口挂了我们会重试,每两分钟还有一次兜底扫描,捞回上游丢掉的回调。
密钥、任务、用量、账单集中在一处,每个任务扣了多少一目了然。
常见问题
见上方「已上线模型」。更多模型正在陆续接入,新模型沿用同一套接口。
每个模型有公开单价,按实际用量扣费,1 credit = $0.005。提交时预扣,任务结束时结算。
目前是 720p。更高档位等确认了上游成本再开——不想卖一个算不清成本的档位。
预扣的 credits 全额自动退回,在消费流水里能看到这笔退款记录。
从任务创建起保留 30 天,到期后文件会被删除。需要长期保存的请在此之前转存到你自己的存储。
不必须。不填回调地址时,用任务 ID 轮询查询接口即可。填了回调地址,投递失败会自动重试。