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

# Veo 2 API Documentation

> Veo 2 is Google DeepMind’s advanced AI video generation model that creates high-quality, realistic video clips. It produces videos with smooth, natural motion and can simulate real-world physics. Learn how to integrate it into your applications below.

Check out Veo 2 API pricing [here](https://api.pollo.ai/pricing?modelName=veo2\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /v1/generation/google/veo-2/video
openapi: 3.0.3
info:
  title: Pollo | AI Video Collection
  description: >-
    ✨RESTful API Document. Model discovery: GET /api/v1/model-specs (public,
    keyless).
  version: 1.0.0
servers:
  - url: https://pollo.ai/api/platform
security: []
externalDocs:
  url: https://pollo.ai/api/platform/api/openapi.json
paths:
  /v1/generation/google/veo-2/video:
    post:
      tags:
        - Video
      summary: veo-2
      operationId: v1-google/veo-2/video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  oneOf:
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 2000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        image:
                          type: string
                          description: >-
                            First-frame / reference image URL (HTTP(S); base64
                            not allowed). Supported formats: JPG/JPEG, PNG.
                            Aspect ratio must be within 1:4 to 4:1.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '9:16'
                          default: '9:16'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        duration:
                          type: number
                          enum:
                            - 5
                            - 8
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 720p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - image
                      title: Image To Video
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 2000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '9:16'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        duration:
                          type: number
                          enum:
                            - 5
                            - 8
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 720p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - prompt
                      title: Text To Video
                webhookUrl:
                  type: string
                  format: uri
                  description: >-
                    Webhook URL (HTTP(S)) that receives status callbacks when
                    the generation succeeds or fails.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                  status:
                    type: string
                    enum:
                      - waiting
                      - succeed
                      - failed
                      - processing
                required:
                  - taskId
                  - status
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````