获取视频生成任务状态
GET
/v1/video/generations/{task_id}
查询通用视频生成任务的状态和结果
请求参数
请求头
Authorization
使用 Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx
路径参数
路径参数（1 个）
| 参数 | 类型 | 默认值 | 说明 | 是否必填 |
|---|---|---|---|---|
task_id | string | — | 创建视频生成任务时返回的任务 ID。 | 是 |
请求示例代码
curl "https://10000router.com/v1/video/generations/abcd1234efgh" \
-H "Authorization: Bearer $API_KEY"const response = await fetch("https://10000router.com/v1/video/generations/abcd1234efgh", {
headers: { Authorization: "Bearer " + process.env.API_KEY }
});
console.log(await response.json());req, _ := http.NewRequest("GET", "https://10000router.com/v1/video/generations/abcd1234efgh", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer res.Body.Close()import os
import requests
response = requests.get(
"https://10000router.com/v1/video/generations/abcd1234efgh",
headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
)
response.raise_for_status()
print(response.json())var request = java.net.http.HttpRequest.newBuilder(java.net.URI.create("https://10000router.com/v1/video/generations/abcd1234efgh"))
.header("Authorization", "Bearer " + System.getenv("API_KEY"))
.GET().build();
var response = java.net.http.HttpClient.newHttpClient().send(request, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("API_KEY"));
var response = await client.GetAsync("https://10000router.com/v1/video/generations/abcd1234efgh");
Console.WriteLine(await response.Content.ReadAsStringAsync());返回响应
响应示例
{
"task_id": "abcd1234efgh",
"status": "completed",
"url": "https://example.com/video.mp4",
"format": "mp4",
"metadata": {
"duration": 5,
"fps": 30,
"width": 1280,
"height": 720,
"seed": 20231234
}
}{
"error": {
"message": "Task not found",
"type": "invalid_request_error",
"param": "task_id",
"code": null
}
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务 ID。 |
status | string | 任务状态：queued、in_progress、completed 或 failed。 |
url | string | 视频资源 URL，任务成功完成时返回。 |
format | string | 视频格式，例如 mp4。 |
metadata | object | 视频时长、帧率、尺寸和随机种子等元数据。 |
error | object | 任务失败时的错误码和错误信息。 |
任务未完成时可以按需轮询；当状态为 failed 时应停止轮询并记录错误。