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

# Pollo 2.0 API Documentation

> Pollo 2.0 offers complete audio integration, character consistency, and flexible 1-10 second video generation. It's fast, affordable, and supports diverse styles, perfect for rapid creative workflows. Integrate its API solution now.

Check out Pollo 2.0 API pricing [here](https://api.pollo.ai/pricing?modelName=pollo-v2-0\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /v1/generation/pollo-ai/pollo-v2/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/pollo-ai/pollo-v2/video:
    post:
      tags:
        - Video
      summary: pollo-v2
      operationId: v1-pollo-ai/pollo-v2/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.
                        resolution:
                          type: string
                          enum:
                            - 480p
                            - 720p
                            - 1080p
                          default: 480p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        duration:
                          type: number
                          enum:
                            - 5
                            - 10
                          default: 5
                          description: The duration of the generated video, in seconds.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                        generateAudio:
                          type: boolean
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                      required:
                        - image
                      title: Image To Video
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 2000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        resolution:
                          type: string
                          enum:
                            - 480p
                            - 720p
                            - 1080p
                          default: 480p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        duration:
                          type: number
                          enum:
                            - 5
                            - 10
                          default: 5
                          description: The duration of the generated video, in seconds.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '9:16'
                            - '4:3'
                            - '3:4'
                            - '1:1'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                        generateAudio:
                          type: boolean
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                      required:
                        - prompt
                      title: Text To Video
                    - type: object
                      properties:
                        refs:
                          type: array
                          items:
                            $ref: '#/components/schemas/RefImage'
                          maxItems: 7
                          description: >-
                            Reference items (image / video / audio) for
                            reference-to-video generation.
                        prompt:
                          type: string
                          maxLength: 2000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        duration:
                          type: integer
                          minimum: 1
                          maximum: 8
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 540p
                            - 720p
                            - 1080p
                          default: 540p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '9:16'
                            - '4:3'
                            - '3:4'
                            - '1:1'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        generateAudio:
                          type: boolean
                          default: true
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - refs
                        - prompt
                      title: Reference 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:
  schemas:
    RefImage:
      type: object
      required:
        - url
      description: A reference item specifying url / type.
      properties:
        url:
          type: string
          description: Media URL (HTTP(S)).
          example: https://example.com/ref.jpg
        type:
          type: string
          enum:
            - image
          description: Media kind. Auto-detected from the URL when omitted.
  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

````