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

# H3 Max Turbo

> Generate videos from text, a first frame, or first and last frames

H3 Max Turbo generates 5–15 second videos at 480p, 768p, or 1080p. Submit a task with `model: "h3-max-turbo"`, then poll its status or provide a `callback_url` to receive the result.

## Generation Modes

* **Text to video:** omit `image_urls` or pass an empty array.
* **First frame:** provide one image in `image_urls`.
* **First and last frames:** provide two images in `image_urls`, with the starting frame first and the ending frame second.

Image-guided generation follows the first image's aspect ratio. Omit `aspect_ratio` whenever `image_urls` contains images.

## Parameter Notes

* `prompt` is required in every mode and accepts up to 50,000 characters.
* `duration` accepts an integer from `5` through `15` seconds and defaults to `5`.
* `resolution` accepts `480p`, `768p`, or `1080p` and defaults to `768p`. Uppercase `P` is also accepted.
* `enable_safety_checker` (boolean) enables the safety checker when `true`. Defaults to `true` in every mode; set `false` to disable it.
* Text-to-video supports `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, and `9:16`. Its default aspect ratio is `16:9`.
* `image_urls` accepts at most two publicly accessible image URLs or Base64 images.
* Reference media, custom audio tracks, seed, and prompt-expansion controls are not available for this model.

## Billing

Video generation is billed by output duration and resolution.


## OpenAPI

````yaml api-manual/video-series/h3-max-turbo.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: PoYo AI - H3 Max Turbo API
  description: Generate videos from text, a first frame, or first and last frames
  version: 1.0.0
servers:
  - url: https://api.poyo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - H3 Max Turbo
      summary: Submit H3 Max Turbo Task
      operationId: submitH3MaxTurboTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              text-to-video:
                summary: Text to Video
                value:
                  model: h3-max-turbo
                  input:
                    prompt: A cinematic aerial view of a coastal city at sunrise
                    duration: 5
                    resolution: 768p
                    aspect_ratio: '16:9'
              image-to-video:
                summary: First Frame
                value:
                  model: h3-max-turbo
                  input:
                    prompt: The camera slowly moves forward through the scene
                    duration: 10
                    resolution: 480p
                    image_urls:
                      - https://example.com/start.jpg
              first-last-frame:
                summary: First and Last Frames
                value:
                  model: h3-max-turbo
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: Daylight gradually turns into sunset
                    duration: 10
                    resolution: 1080p
                    image_urls:
                      - https://example.com/start.jpg
                      - https://example.com/end.jpg
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - h3-max-turbo
          example: h3-max-turbo
        callback_url:
          type: string
          format: uri
          description: Optional webhook callback URL.
        input:
          $ref: '#/components/schemas/H3MaxTurboInput'
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1790245800-h3turbo1
            status:
              type: string
              example: not_started
            created_time:
              type: string
              format: date-time
              example: '2026-09-24T10:30:00Z'
              description: ISO 8601 timestamp when the task was created.
      example:
        code: 200
        data:
          task_id: task-unified-1790245800-h3turbo1
          status: not_started
          created_time: '2026-09-24T10:30:00Z'
    H3MaxTurboInput:
      type: object
      required:
        - prompt
      additionalProperties: false
      properties:
        prompt:
          type: string
          minLength: 1
          maxLength: 50000
          description: >-
            Text prompt describing the generated video. Required in both modes
            and must not consist only of whitespace.
        duration:
          type: integer
          minimum: 5
          maximum: 15
          default: 5
          description: Generated video duration in seconds.
        resolution:
          type: string
          enum:
            - 480p
            - 768p
            - 1080p
            - 480P
            - 768P
            - 1080P
          default: 768p
          description: >-
            Output resolution: 480p, 768p or 1080p. Uppercase P is also
            accepted.
        enable_safety_checker:
          type: boolean
          default: true
          description: >-
            If set to true, the safety checker will be enabled. Defaults to
            true.
        aspect_ratio:
          type: string
          enum:
            - '21:9'
            - '16:9'
            - '4:3'
            - '1:1'
            - '3:4'
            - '9:16'
          description: >-
            Text-to-video only; defaults to 16:9. Omit when image_urls contains
            images.
        image_urls:
          type: array
          maxItems: 2
          items:
            type: string
            minLength: 1
          description: >-
            First frame and optional last frame, in that order. Use public
            HTTP(S) image URLs or Base64 images. Omit or pass [] for
            text-to-video.
      not:
        required:
          - image_urls
          - aspect_ratio
        properties:
          image_urls:
            minItems: 1
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````