BOTCF02 Seedance 视频使用教程

准备工作

在 BotCF 控制台创建令牌，并按需要选择以下分组：

接口地址和令牌可先写入环境变量：

export BASE_URL="https://botcf.com"
export API_KEY="sk-你的BotCF令牌"

模型列表

1. 上传素材

创建图片、视频或音频素材。真人脸图片必须先执行此步骤。

curl --location "$BASE_URL/v1/sd/assets" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "URL": "https://example.com/avatar.jpg",
    "Name": "avatar_front",
    "AssetType": "Image"
  }'

成功响应中的 data.Id 是素材 ID：

{
  "success": true,
  "data": {
    "Id": "asset-20260705003737-njxmg",
    "base_resp": {
      "status_code": 0,
      "status_msg": "success"
    }
  }
}

查询素材状态：

curl "$BASE_URL/v1/sd/assets/asset-20260705003737-njxmg" \
  --header "Authorization: Bearer $API_KEY"

2. 生成视频

提交任务后接口会立即返回任务 ID。下例使用已上传的人脸素材，因此模型必须为 -hc：

curl --location "$BASE_URL/v1/video/generate" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "dreamina-seedance-2-0-hc",
    "content": [
      {
        "type": "text",
        "text": "这个人在跳舞"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://asset-20260705003737-njxmg"
        },
        "role": "reference_image"
      }
    ],
    "duration": 5,
    "resolution": "480p",
    "ratio": "1:1",
    "generate_audio": false,
    "watermark": false
  }'

响应中的 task.id 是 BotCF 任务 ID：

{
  "task": {
    "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "pending",
    "model": "dreamina-seedance-2-0-hc",
    "duration_seconds": 5,
    "outputs": [],
    "error": null,
    "created_at": "2026-07-20T08:00:00Z",
    "completed_at": null
  }
}

content 类型

3. 查询任务

轮询单个任务，直到 status 变为 completed 或 failed：

curl "$BASE_URL/v1/video/tasks/task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --header "Authorization: Bearer $API_KEY"

任务完成后从 task.outputs 获取视频地址：

{
  "task": {
    "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "completed",
    "model": "dreamina-seedance-2-0-hc",
    "duration_seconds": 5,
    "outputs": ["https://example.com/generated-video.mp4"],
    "error": null,
    "usage": {
      "completion_tokens": 40594,
      "total_tokens": 40594
    }
  }
}

查看当前令牌所属用户提交的任务列表：

curl "$BASE_URL/v1/video/tasks" \
  --header "Authorization: Bearer $API_KEY"

价格

BOTCF02 上游密钥实际使用 Standard 计费档，按视频 token 计费，不按秒计费。下表是源站实际结算价上浮 50% 后的最终售价，任务完成时以 usage.total_tokens 结算，单位为美元 / 100 万 token。

任务状态