> ## 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">
  작업 성공 후 결과 비디오 URL입니다.
</ResponseField>

<ResponseField name="data.data" type="object">
  `content.video_url`, `usage.total_tokens` 등의 필드를 포함할 수 있는 원본 업스트림 작업 데이터입니다.
</ResponseField>