视频生成

Video Task Query

GET /v1/contents/generations/tasks/{id} —— 轮询视频生成任务的状态与结果

查询视频生成提交的异步任务结果。任务状态流转：queued → running → succeeded / failed。

轮询视频生成任务的状态和结果，task_id 来自提交接口。

GEThttps://coder.api.visioncoder.cn/v1/contents/generations/tasks/{id}

鉴权

Authorization: Bearer YOUR_API_KEY

路径参数

参数	说明
`id`	提交视频生成任务后返回的 `id`

调用示例

curl https://coder.api.visioncoder.cn/v1/contents/generations/tasks/cgt-01HZY3K8Q2W7X9V4 \
  -H "Authorization: Bearer $VISIONCODER_API_KEY"

import time
import requests

def wait_for_video(task_id, api_key):
    url = f"https://coder.api.visioncoder.cn/v1/contents/generations/tasks/{task_id}"
    headers = {"Authorization": f"Bearer {api_key}"}
    while True:
        data = requests.get(url, headers=headers).json()
        if data["status"] == "succeeded":
            return data["content"]["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(data.get("error", "generation failed"))
        time.sleep(5)

video_url = wait_for_video("cgt-01HZY3K8Q2W7X9V4", "YOUR_API_KEY")
print(video_url)

async function waitForVideo(taskId) {
  const url = `https://coder.api.visioncoder.cn/v1/contents/generations/tasks/${taskId}`;
  const headers = { Authorization: `Bearer ${process.env.VISIONCODER_API_KEY}` };
  for (;;) {
    const data = await (await fetch(url, { headers })).json();
    if (data.status === "succeeded") return data.content.video_url;
    if (data.status === "failed") throw new Error(data.error || "generation failed");
    await new Promise((r) => setTimeout(r, 5000));
  }
}

console.log(await waitForVideo("cgt-01HZY3K8Q2W7X9V4"));

任务状态

`status`	含义	该怎么做
`queued`	已排队，还没开始	继续轮询
`running`	生成中	继续轮询
`succeeded`	完成	从 `content.video_url` 取视频，尽快下载
`failed`	失败	看 `error` 字段，多为内容策略拦截或参考图不合规

响应示例

生成完成（status = succeeded）：

{
  "id": "cgt-01HZY3K8Q2W7X9V4",
  "model": "grok-imagine-video",
  "status": "succeeded",
  "content": {
    "video_url": "https://cdn.visioncoder.cn/videos/cgt-01HZY3K8Q2W7X9V4.mp4"
  },
  "created_at": 1779438767,
  "updated_at": 1779438892
}

生成中（status = running）：

{
  "id": "cgt-01HZY3K8Q2W7X9V4",
  "model": "grok-imagine-video",
  "status": "running",
  "created_at": 1779438767,
  "updated_at": 1779438772
}

生成失败（status = failed）：

{
  "id": "cgt-01HZY3K8Q2W7X9V4",
  "model": "grok-imagine-video",
  "status": "failed",
  "error": "prompt rejected by content policy",
  "created_at": 1779438767,
  "updated_at": 1779438790
}

created_at 和 updated_at 都是 Unix 秒级时间戳。

加群 & 客服