H3 Max Video Generation

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "h3-max",
  "input": {
    "prompt": "A cinematic aerial view of a coastal city at sunrise"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1790245800-h3max01",
    "status": "not_started",
    "created_time": "2026-09-24T10:30:00Z"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "h3-max",
  "input": {
    "prompt": "A cinematic aerial view of a coastal city at sunrise"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1790245800-h3max01",
    "status": "not_started",
    "created_time": "2026-09-24T10:30:00Z"
  }
}

Check the live model catalog for availability before submitting a request.

Successful submissions return a task_id. Use Query Task Status to retrieve the result, or supply callback_url at the top level to receive a notification when the task finishes or fails.

Input modes

Mode	Input
Text to video	Supply a prompt with no media.
Image to video	Supply `image_urls` with a starting frame and, optionally, an ending frame.
Reference to video	Supply `reference_image_urls`; optionally add reference video and audio.

Starting and ending frames cannot be combined with any reference assets. Reference video and audio always require at least one reference image. Empty arrays do not select a mode.

Parameters

prompt is required, with up to 50,000 characters.
duration is an integer from 5 through 15 seconds; the default is 5.
resolution is 480p, 768p, or 1080p; the default is 768p.
enable_safety_checker (boolean) enables the safety checker when true. Defaults to true in every mode; set false to disable it.
image_urls accepts up to 2 images, in starting-frame and ending-frame order.
reference_image_urls accepts up to 9 images.
reference_video_urls accepts up to 3 clips. Each clip must be 2–15 seconds, and their combined duration must not exceed 15 seconds.
reference_audio_urls accepts up to 3 clips, also 2–15 seconds each and at most 15 seconds combined.
Reference images, videos, and audio must total at most 12 files.
Text mode supports 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16, defaulting to 16:9.
Reference mode supports the same ratios plus adaptive, which is its default.
Image mode follows the starting image; do not pass aspect_ratio.

Media URLs must be publicly accessible HTTP(S) download links. Mention references in the prompt as Image 1, Video 1, and Audio 1, following the order in each list. The server checks reference metadata before submitting. If it cannot reliably determine the reference usage, the request is rejected before credits are charged. Reference images currently support 1:1, 4:3, 3:4, 16:9, 9:16, 5:2, and 2:5 shapes. Reference videos must use a constant 24 fps, square pixels, no rotation metadata, and a 16:9 or 9:16 shape. After limiting the counted frames to the requested output duration, the frame count must be 48, 120, 240, or 360. Reference audio must be 32 kHz with a decoded sample count divisible by 800, and each clip must not exceed the requested output duration. Other media formats or timing patterns are rejected before charging.

Examples

Text to video

{
  "model": "h3-max",
  "input": {"prompt": "A cinematic aerial view of a coastal city at sunrise"}
}

Starting and ending frames

{
  "model": "h3-max",
  "input": {
    "prompt": "The camera glides forward as daylight turns into sunset",
    "duration": 8,
    "resolution": "1080p",
    "image_urls": ["https://example.com/start.jpg", "https://example.com/end.jpg"]
  }
}

Multimodal references

{
  "model": "h3-max",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "Image 1 follows the movement in Video 1 with the atmosphere of Audio 1",
    "duration": 10,
    "resolution": "768p",
    "reference_image_urls": ["https://example.com/subject.jpg"],
    "reference_video_urls": ["https://example.com/motion.mp4"],
    "reference_audio_urls": ["https://example.com/atmosphere.wav"]
  }
}

Billing

Output charges depend on duration and resolution. Each reference request includes a shared reference allowance; material above that allowance incurs an additional fee. The server calculates reference usage across images, video, and audio together. Do not supply token counts or media metadata in your request.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model

enum<string>

required

Available options:

h3-max

Example:

"h3-max"

input

object

required

At most 12 reference assets in total. All media URLs must use HTTP(S). Reference video and audio each require reference images. Media metadata and billing tokens are computed by the server.

Show child attributes

callback_url

string<uri>

Optional webhook callback URL.

Response

200 - application/json

Task submitted successfully

code

integer

required

Example:

200

data

object

required

Show child attributes

Overview

Image Model

Video Model

Music Model

Chat Model

3D Model

Task Management

H3 Max Video Generation

Input modes

Parameters

Examples

Billing

Authorizations

Body

Response

​Input modes

​Parameters

​Examples

​Billing

Authorizations

Body

Response

Input modes

Parameters

Examples

Billing