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

# Happy Horse 1.0 API Documentation

> Happy Horse 1.0 API delivers synchronized audio-video generation with realistic motion, precise lip-sync, cinematic visuals, prompt-based camera moves, and multilingual support. Integrate the Happy Horse 1.0 API now.

Check out Happy Horse 1.0 API pricing [here](https://api.pollo.ai/pricing?modelName=happyhorse-1.0\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /v1/generation/alibaba/happyhorse-1-0/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/alibaba/happyhorse-1-0/video:
    post:
      tags:
        - Video
      summary: happyhorse-1-0
      operationId: v1-alibaba/happyhorse-1-0/video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  oneOf:
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 5000
                          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.
                        duration:
                          type: integer
                          minimum: 3
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 1080p
                            - 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: 5000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        duration:
                          type: integer
                          minimum: 3
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 1080p
                            - 720p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '1:1'
                            - '4:3'
                            - '3:4'
                            - '9:16'
                          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.
                      required:
                        - prompt
                      title: Text To Video
                    - type: object
                      properties:
                        refs:
                          type: array
                          items:
                            $ref: '#/components/schemas/RefImage'
                          maxItems: 9
                          description: >-
                            Reference items (image / video / audio) for
                            reference-to-video generation.
                        prompt:
                          type: string
                          maxLength: 5000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        duration:
                          type: integer
                          minimum: 3
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        aspectRatio:
                          type: string
                          enum:
                            - '1:1'
                            - '4:3'
                            - '3:4'
                            - '16:9'
                            - '9:16'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        resolution:
                          type: string
                          enum:
                            - 720p
                            - 1080p
                          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:
                        - refs
                        - prompt
                      title: Reference To Video
                      description: |-
                        Constraints:
                        - at least one image ref is required
                        - at most 9 image refs are allowed
                        - video refs are not supported
                        - audio refs are not supported
                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

````