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

# 获取 Seedance 视频任务

> <ul><li>查询 Seedance 视频生成任务状态。</li><li>任务完成后可在 result_url 中获取视频链接。</li></ul>

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl --request GET \
    --url 'https://api.elkapi.com/v1/video/generations/task_abc123' \
    --header 'Authorization: Bearer <token>'
  ```

  ```python Python theme={null} theme={null}
  import requests

  url = "https://api.elkapi.com/v1/video/generations/task_abc123"
  headers = {
      "Authorization": "Bearer <token>"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null} theme={null}
  const response = await fetch("https://api.elkapi.com/v1/video/generations/task_abc123", {
    method: "GET",
    headers: {
      "Authorization": "Bearer <token>"
    }
  });

  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null} theme={null}
  {
    "code": "success",
    "message": "",
    "data": {
      "task_id": "task_abc123",
      "platform": "doubao-video",
      "action": "generate",
      "status": "SUCCESS",
      "progress": "100%",
      "result_url": "https://example.com/video.mp4",
      "created_at": 1760000000,
      "updated_at": 1760000060,
      "data": {
        "id": "upstream_task_id",
        "status": "succeeded",
        "content": {
          "video_url": "https://example.com/video.mp4"
        },
        "usage": {
          "completion_tokens": 123456,
          "total_tokens": 123456
        }
      }
    }
  }
  ```

  ```json 404 theme={null} theme={null}
  {
    "error": {
      "message": "task_not_exist",
      "type": "new_api_error",
      "param": "",
      "code": "task_not_exist"
    }
  }
  ```
</ResponseExample>

## Authorizations

<ParamField header="Authorization" type="string" required>
  所有接口均需要使用 Bearer Token 进行认证。

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## Path Parameters

<ParamField path="task_id" type="string" required>
  创建任务接口返回的 `id` 或 `task_id`。
</ParamField>

## Response

<ResponseField name="code" type="string">
  响应状态。成功时为 `success`。
</ResponseField>

<ResponseField name="data.task_id" type="string">
  ElkAPI 公开任务 ID。
</ResponseField>

<ResponseField name="data.platform" type="string">
  任务平台。Seedance 通常为 `doubao-video`。
</ResponseField>

<ResponseField name="data.status" type="string">
  内部任务状态。

  常见值：`SUBMITTED`、`QUEUED`、`IN_PROGRESS`、`SUCCESS`、`FAILURE`
</ResponseField>

<ResponseField name="data.progress" type="string">
  任务进度。

  示例：`10%`、`50%`、`100%`
</ResponseField>

<ResponseField name="data.result_url" type="string">
  任务成功后的结果视频地址。
</ResponseField>

<ResponseField name="data.data" type="object">
  上游原始任务数据，可能包含 `content.video_url`、`usage.total_tokens` 等字段。
</ResponseField>