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: "wan3.0-video-prime"
prompt
string

Text prompt used to describe the expected generated video content. Required for the text-to-video scenario.

Maximum string length: 20000
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 10 images are supported.

Maximum array length: 10
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. Maximum 5 clips, total duration no more than 15 seconds.

Maximum array length: 5
audio_urls
string[]

Refer to the audio, with a maximum of 5 segments and a total duration no more than 15 seconds.

Maximum array length: 5
file_url
string
default:""

Reference File, maximum one, cannot be input together with link url. Supported formats: docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, md.

The URL address of the public web page. Only public web pages that do not require login are supported for parsing. Cannot be input together with file.

duration
enum<integer>
default:5

The duration of the generated video, in seconds. -1 lets the model decide the duration.

Available options:
-1
Required range: 2 <= x <= 30
resolution
enum<string>
default:1080P
Available options:
480P,
720P,
1080P
aspect_ratio
enum<string>
default:adaptive
Available options:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16
generate_audio
boolean
default:true

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