> ## 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}

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

Use this endpoint to query the current status, progress, and error state of a video-generation task.

* Authenticate with `Authorization: Bearer {API_KEY}`
* The key path parameter is `video_id`
* This endpoint is normally polled after task creation
* If you maintain an internal job table, store provider status separately from product status


## 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

````