> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gogogotoken.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务查询与轮询

> 通过 task_id 查询视频生成任务状态与结果

视频生成任务提交后，通过 `task_id` 轮询查询任务状态与生成结果。

<RequestExample>
  ```bash cURL theme={null}
  curl https://gogogotoken.com/v1/video/generations/task_1234567890 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 处理中 theme={null}
  {
    "code": "success",
    "data": {
      "status": "IN_PROGRESS",
      "progress": "50%"
    }
  }
  ```

  ```json 生成成功 theme={null}
  {
    "code": "success",
    "data": {
      "status": "SUCCESS",
      "progress": "100%",
      "result_url": "https://assets.example.com/generated-video.mp4"
    }
  }
  ```

  ```json Token 计费 theme={null}
  {
    "id": "task_1234567890",
    "object": "video",
    "model": "doubao-seedance-2-0",
    "status": "completed",
    "progress": 100,
    "output": {
      "video_url": "https://assets.example.com/generated-video.mp4"
    },
    "usage": {
      "total_tokens": 108900,
      "completion_tokens": 108900
    }
  }
  ```
</ResponseExample>

## 路径参数

<ParamField path="task_id" type="string" required>
  视频生成任务 ID。
</ParamField>

## 请求头

<ParamField header="Authorization" type="string" required>
  API Key 鉴权信息，格式为 `Bearer YOUR_API_KEY`。
</ParamField>

## 响应体

<ResponseField name="status" type="string">
  任务状态，例如 `queued`、`running`、`SUCCESS`、`completed`、`failed`。
</ResponseField>

<ResponseField name="progress" type="string">
  任务进度。不同响应格式中可能是字符串百分比或数字。
</ResponseField>

<ResponseField name="result_url" type="string">
  生成成功后返回的视频 URL。
</ResponseField>

<ResponseField name="output.video_url" type="string">
  OpenAI 兼容结构中的视频 URL。
</ResponseField>

<ResponseField name="usage" type="object">
  Token 计费任务的用量信息。
</ResponseField>

## 轮询建议

状态通常按以下顺序变化：

```text theme={null}
queued -> running -> succeeded / failed
```

成功后的 `result_url` 约 24 小时内有效，请及时下载。