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

# /v1/videos/{video_id}

> 비디오 생성 작업의 현재 상태 및 진행 상황을 검색합니다.

이 엔드포인트를 사용하여 비디오 생성 작업의 현재 상태, 진행률 및 오류 상태를 쿼리합니다.

* `Authorization: Bearer {API_KEY}`로 인증
* 주요 경로 매개변수는 `video_id`입니다.
* 이 엔드포인트는 일반적으로 작업 생성 후 폴링됩니다.
* 내부 작업 테이블을 유지 관리하는 경우 공급자 상태를 제품 상태와 별도로 저장하십시오.


## OpenAPI

````yaml GET /v1/videos/{video_id}
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://maas.apigo.ai
security:
  - bearerAuth: []
paths:
  /v1/videos/{video_id}:
    get:
      summary: OpenAI video status
      description: Retrieves the current status and progress of a video generation task.
      parameters:
        - name: video_id
          in: path
          description: Video ID
          required: true
          schema:
            type: string
            example: video_123456789
      responses:
        '200':
          description: Successful video task status response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIVideoTask'
              example:
                id: video_123456789
                object: video
                created_at: 1741570283
                completed_at: 1741570383
                model: sora-2
                status: pending
                progress: 50
                expires_at: 1741656683
                seconds: '4'
                size: 720x1280
                remixed_from_video_id: <string>
                error:
                  code: <string>
                  message: <string>
                  type: <string>
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    OpenAIVideoTask:
      type: object
      required:
        - id
        - object
        - status
      properties:
        id:
          type: string
          description: Video task ID.
          example: video_123456789
        object:
          type: string
          enum:
            - video
          description: Object type.
        created_at:
          type: integer
          format: int64
          description: Creation timestamp.
        completed_at:
          type: integer
          format: int64
          description: Completion timestamp.
        model:
          type: string
          description: Model used for generation.
        status:
          type: string
          enum:
            - pending
            - in_progress
            - completed
            - failed
          description: Current task status.
        progress:
          type: integer
          minimum: 0
          maximum: 100
          description: Task progress percentage.
        expires_at:
          type: integer
          format: int64
          description: Expiration timestamp for the generated asset.
        seconds:
          type: string
          description: Video duration in seconds.
        size:
          type: string
          enum:
            - 720x1280
            - 1280x720
          description: Video resolution.
        remixed_from_video_id:
          type: string
          description: Source video ID when the task comes from remix.
        error:
          $ref: '#/components/schemas/OpenAIVideoError'
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    OpenAIVideoError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        type:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````