xbxbapi

创建任务

提交任意模型的生成任务。

POST/api/v1/jobs/createTask

创建一个异步生成任务,所有模型共用这个接口。请求受理成功时会预扣 credits。

请求体

请求
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "一只橘猫在阳光照进的窗台上伸懒腰"
  },
  "callBackUrl": "https://your-server.com/webhook"
}

公共字段

字段类型必填说明
modelstring是模型标识,见下表
inputobject是模型参数,各模型页面有详细说明
callBackUrlstring否不填写时通过查询接口轮询状态

模型

模型model 取值类型
Seedance 2.0seedance-2.0视频
Seedance 2.0 Fastseedance-2.0-fast视频

响应

成功响应
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xb_a1b2c3d4e5f6...",
    "creditsCharged": 165
  }
}

请立即保存 taskId,查询任务状态和回调去重都需要使用它。

计费行为

提交任务时预扣 credits,金额由输出时长和模型单价计算。任务最终失败时会自动全额退回。

本页目录