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

# Retrieve Video

> Get a video job. Poll until `status` is `completed` or `failed`.



## OpenAPI

````yaml https://api.edenai.run/v3/docs/openapi.json get /v3/videos/{video_id}
openapi: 3.1.0
info:
  title: Eden AI API V3
  version: 3.0.0
servers:
  - url: https://api.edenai.run
    description: Production server
security: []
paths:
  /v3/videos/{video_id}:
    get:
      tags:
        - Videos
      summary: Retrieve Video
      description: Get a video job. Poll until `status` is `completed` or `failed`.
      operationId: retrieve_video_v3_videos__video_id__get
      parameters:
        - name: video_id
          in: path
          required: true
          schema:
            type: string
            title: Video Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoObject'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - AuthBearer: []
components:
  schemas:
    VideoObject:
      properties:
        id:
          type: string
          title: Id
          description: Job id. Use it to poll, download and delete.
        object:
          type: string
          const: video
          title: Object
          default: video
        status:
          type: string
          enum:
            - queued
            - in_progress
            - completed
            - failed
          title: Status
          description: queued, in_progress, completed or failed.
        progress:
          anyOf:
            - type: integer
            - type: 'null'
          title: Progress
          description: 0 while running or failed, 100 when completed.
        created_at:
          type: integer
          title: Created At
          description: Unix timestamp (seconds) of job creation.
        completed_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Completed At
          description: Unix timestamp (seconds) when the job finished.
        expires_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Expires At
          description: 'Always null: Eden AI keeps the result.'
        model:
          type: string
          title: Model
          description: The `provider/model` that ran the job.
        seconds:
          anyOf:
            - type: string
            - type: 'null'
          title: Seconds
          description: Clip length in seconds, as a string.
        size:
          anyOf:
            - type: string
            - type: 'null'
          title: Size
          description: Requested resolution as `WIDTHxHEIGHT`.
        remixed_from_video_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Remixed From Video Id
          description: 'Always null: remix is not supported.'
        error:
          anyOf:
            - $ref: '#/components/schemas/VideoError'
            - type: 'null'
          description: Set when status is failed.
        provider:
          type: string
          title: Provider
          description: 'Eden extension: provider that ran the job.'
        cost:
          type: number
          title: Cost
          description: >-
            Eden extension: cost in USD. 0 while the job is queued or in
            progress (the reserved estimate is not surfaced); the settled amount
            once the job completes or fails.
      type: object
      required:
        - id
        - status
        - created_at
        - model
        - provider
        - cost
      title: VideoObject
      description: >-
        A video generation job, in OpenAI's video object shape.


        `provider` and `cost` are Eden extensions. Download the finished video
        from

        ``GET /v3/videos/{video_id}/content``.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    VideoError:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code.
        message:
          type: string
          title: Message
          description: Human-readable error message.
      type: object
      required:
        - code
        - message
      title: VideoError
      description: Why a video job failed.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    AuthBearer:
      type: http
      scheme: bearer

````