Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Use your APIPod API key as a Bearer token in the Authorization header.

Body

application/json
model
string
required

Public APIPod model ID.

Allowed value: "minimax-h3"
prompt
string
required

Generation instructions. Required for every scenario, up to 7000 characters.

Required string length: 1 - 7000
duration
integer
default:4
required

Duration of the generated video in seconds. Available values: 4-15.

Required range: 4 <= x <= 15
image_urls
string[]

Image URLs. Scenario inference applies: when images are the only media input and 1-2 URLs are provided they are treated as first/last frames (image-to-video); with other reference media present or more than 2 URLs, all images are treated as reference images. Pair with the role field to pin the semantics explicitly. Up to 9 images are supported.

Maximum array length: 9
role
enum<string>

Explicit interpretation of image_urls. reference_images: all images are treated as reference images regardless of count. first_last_frame: images are treated as the first frame plus an optional last frame (max 2; cannot be combined with reference videos or audios). When omitted, the scenario is inferred from the materials.

Available options:
reference_images,
first_last_frame
video_urls
string[]

Reference videos. Audio cannot be used alone; at least one reference image or one reference video is required.

Maximum array length: 3
audio_urls
string[]

Audio cannot be used alone; at least one reference image or one reference video is required.

Maximum array length: 3
resolution
enum<string>
default:2K

Video resolution. Available values: 768P and 2K.

Available options:
768P,
2K
aspect_ratio
enum<string>
default:adaptive

Aspect ratio of the generated video. Defaults to adaptive; required and cannot be adaptive for the text-to-video scenario.

Available options:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16

Response

200 - application/json

Task accepted

Standard response for task submission

code
integer
required
data
Task Submit Data · object
required

Data content for task submission

message
string
required