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: "seedance-2.0-fast"
prompt
string
required

Generation or editing instructions, up to 30000 characters. It is recommended to keep the prompt to no more than 500 Chinese characters or 1,000 English words. Lengthy text will lead to scattered information, and the model may ignore details and only focus on key points, resulting in missing elements in the generated video.

Maximum string length: 30000
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; each image must be smaller than 30 MB.

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 video URLs. Up to 3 videos are supported; each video lasts 2-15 seconds and the total duration of all videos must not exceed 15 seconds.

Maximum array length: 3
audio_urls
string[]

Reference audio URLs. Up to 3 audios are supported; each audio lasts 2-15 seconds and the total duration of all audios must not exceed 15 seconds. Audio cannot be used alone; include at least one image or video reference.

Maximum array length: 3
duration
enum<integer>
default:5

Video duration in seconds, from 4 to 15.

Available options:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Required range: 4 <= x <= 15
resolution
enum<string>
default:720p

Generate video resolution.

Available options:
480p,
720p
aspect_ratio
enum<string>
default:adaptive

Aspect ratio of the generated video. When the ratio is configured as adaptive, the model will automatically adapt the aspect ratio according to the generation scenario.

Available options:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
generate_audio
boolean
default:true

Controls whether the generated video contains audio synchronized with the visuals.

Allow retrieving live information when the channel supports it.

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