取消或删除视频生成任务

本接口用于取消排队中的视频生成任务，或删除已终止任务的记录。不同任务状态下，DELETE 操作的行为不同，详见下方说明。

请求方法

DELETE：<ai-api-base-url>/llm/v1/contents/generations/tasks/{task_id}

其中，<ai-api-base-url> 为您的 API Key 所属数据中心的域名：

• 北京数据中心：https://ai.rong-api.com
• 北美数据中心：https://ai.us-light-api.com

请求头参数

参数名	类型	是否必填	默认值	说明
Authorization	string	是	-	身份认证令牌，格式为 Bearer <your API key>，需替换为实际 API Key，用于验证用户权限。

路径参数

参数名	类型	是否必填	说明
task_id	string	是	需要取消或删除的视频生成任务 ID。

各状态下的操作行为

当前任务状态	是否支持 DELETE	操作含义	操作后状态
queued（排队中）	是	取消任务排队，任务状态变更为 cancelled。	cancelled
running（生成中）	否	不支持取消或删除。	-
succeeded（已完成）	是	删除任务记录，删除后将无法继续查询。	-
failed（已失败）	是	删除任务记录，删除后将无法继续查询。	-
cancelled（已取消）	否	不支持再次删除。	-
expired（已超时）	是	删除任务记录，删除后将无法继续查询。	-

关于运行中任务的说明

目前对于 Seedance 2.0 这类大参数量的视频或图像生成模型，融云暂未提供开放的强制中止 API（例如对运行中任务执行 DELETE）。当任务从 queued 进入 running 后，底层 GPU 会开始连续多步降噪推理（Denoising steps）。出于算力集群吞吐效率保护，该过程不可逆转。即使客户端主动断开连接，后台任务仍会继续执行，并扣减对应的 Token 或时长额度。

请求示例

cURL

bash

curl --request DELETE \
  --url '<ai-api-base-url>/llm/v1/contents/generations/tasks/cgt-2025xxxxxx-xxxx' \
  --header 'Authorization: Bearer <token>'

Python

python

import requests

task_id = "cgt-2025xxxxxx-xxxx"  # 替换为实际任务 ID
headers = {
    "Authorization": "Bearer <token>"
}

response = requests.delete(
    f"<ai-api-base-url>/llm/v1/contents/generations/tasks/{task_id}",
    headers=headers
)
print(response.status_code)

JavaScript

JavaScript

const taskId = 'cgt-2025xxxxxx-xxxx'; // 替换为实际任务 ID

const options = {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer <token>'
  }
};

fetch(`<ai-api-base-url>/llm/v1/contents/generations/tasks/${taskId}`, options)
  .then(response => {
    if (response.ok) {
      console.log('操作成功');
    } else {
      return response.json().then(err => console.error('操作失败：', err));
    }
  })
  .catch(err => console.error(err));

返回结果

本接口无返回参数，操作成功时返回 HTTP 200 状态码。