查询视频任务状态

GET

/v1/video/generations/{task_id}

查询视频生成任务的状态。使用创建任务时返回的 task_id 作为路径参数。

任务状态包括排队、生成中和完成（成功或失败）。成功后，响应中的 data.result_url 指向视频内容地址；下载该地址时仍须携带有效的 Bearer API Key。

• 查询请求成功（HTTP 200）只表示成功读取了任务记录，不代表视频生成成功。必须检查 data.status 判断任务是否成功完成。
• 建议每隔 5–10 秒查询一次，避免频繁请求。

授权

bearerAuth

在请求头中传入 Authorization: Bearer <CLAWPOWER_API_KEY>。

类型

HTTP (bearer)

参数

路径参数

task_id*

创建任务时返回的公共任务 ID。

类型

string

必填

示例"task_0123456789abcdef"

响应

成功读取任务记录。任务可能处于任何状态，需检查 data.status。

Content-Type

application/json

{

  

"code": "success",

  

"message": "",

  

"data": {

  

  

"task_id": "task_0123456789abcdef",

  

  

"status": "IN_PROGRESS",

  

  

"progress": "50%",

  

  

"fail_reason": ""

  

}

}

GET

/v1/video/generations/{task_id}

试验场

授权

bearerAuth

变量

键

值

task_id*

示例

下载视频

当任务状态为 SUCCESS 时，查询响应的 data.result_url 字段会返回视频内容地址。下载时必须携带有效的 Bearer API Key。

下载方式

• result_url 是一次性的内容地址，拿到后应尽快下载。
• 下载时必须携带与创建、查询任务时相同的 Authorization: Bearer <CLAWPOWER_API_KEY> 请求头；缺少或无效的 Key 会返回 HTTP 401。
• 如果状态不是 SUCCESS（如 IN_PROGRESS、FAILURE），则没有 result_url，需要继续等待或处理失败原因。

cURL

curl -L \
  --header "Authorization: Bearer $CLAWPOWER_API_KEY" \
  -o output.mp4 \
  "https://api.clawpowerai.com/v1/videos/task_0123456789abcdef/content"

Python

import requests

api_key = "your_api_key"
result_url = "https://api.clawpowerai.com/v1/videos/task_0123456789abcdef/content"
response = requests.get(
    result_url,
    headers={"Authorization": f"Bearer {api_key}"},
    timeout=120,
)
response.raise_for_status()

with open("output.mp4", "wb") as f:
    f.write(response.content)

print("视频已保存为 output.mp4")