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

# Unduh konten video Omni

> Unduh file MP4 yang telah selesai untuk tugas video Omni beta melalui route content.

Gunakan endpoint ini untuk mengunduh file MP4 untuk tugas video Omni beta yang telah selesai. Jika tugas masih berjalan, API akan mengembalikan error JSON alih-alih byte video.

<Badge color="orange" size="sm" shape="pill">Beta</Badge>

## Sebelum mengunduh

* Buat tugas dengan [Create an Omni video](./create).
* Lakukan polling dengan [Retrieve an Omni video](./retrieve) hingga `status` bernilai `completed`.
* Kirim task ID yang sama ke endpoint ini.

## Simpan media yang telah selesai

Body respons berupa konten biner `video/mp4`. Simpan byte tersebut ke penyimpanan Anda sendiri saat aplikasi Anda memerlukan akses yang tahan lama ke media yang dihasilkan.


## OpenAPI

````yaml api/openapi/video/omni/get-retrieve-content.openapi.json GET /v1/videos/{task_id}/content
openapi: 3.1.0
info:
  title: Omni Video Content API
  version: 1.0.0
  description: >-
    Download the completed MP4 file for a beta Omni video task. The endpoint
    returns binary video content on success and a JSON error if the task is not
    ready.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /v1/videos/{task_id}/content:
    get:
      summary: Download Omni video content
      description: >-
        Download the generated MP4 file after a beta Omni video task reaches
        completed status.
      operationId: omni_retrieve_video_content
      parameters:
        - name: task_id
          in: path
          required: true
          description: Task ID returned by POST /v1/videos.
          schema:
            type: string
          example: task_example
      responses:
        '200':
          description: Binary MP4 video content.
          content:
            video/mp4:
              schema:
                type: string
                format: binary
        '400':
          description: The task is not completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: 'Task is not completed yet. Status: IN_PROGRESS'
                  type: invalid_request_error
        '404':
          description: The task ID does not match a task for the authenticated user.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: Task not found
                  type: invalid_request_error
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: Shell
          label: Download MP4
          source: |-
            curl https://api.cometapi.com/v1/videos/<TASK_ID>/content \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              --output output.mp4
        - lang: Python
          label: Download MP4
          source: |-
            import os
            from pathlib import Path

            import requests

            TASK_ID = "<TASK_ID>"
            response = requests.get(
                f"https://api.cometapi.com/v1/videos/{TASK_ID}/content",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                timeout=300,
            )
            response.raise_for_status()
            Path("output.mp4").write_bytes(response.content)
        - lang: JavaScript
          label: Download MP4
          source: |-
            import { writeFile } from "node:fs/promises";

            const TASK_ID = "<TASK_ID>";
            const response = await fetch(
              `https://api.cometapi.com/v1/videos/${TASK_ID}/content`,
              { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
            );

            if (!response.ok) {
              throw new Error(await response.text());
            }

            const video = new Uint8Array(await response.arrayBuffer());
            await writeFile("output.mp4", video);
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
          properties:
            message:
              type: string
              description: Human-readable error message.
            type:
              type: string
              description: Error category.
            code:
              type:
                - string
                - 'null'
              description: Short error code.
          additionalProperties: true
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer authentication. Use your CometAPI API key.

````