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.5-draft"
draft_task_id
string

The data.task_id of a completed draft (from GET /v1/videos/status/{task_id}), created by the same user within the last 7 days. When set, creates the 1080p final video; only resolution, output_format, watermark, and callback_url may be sent alongside it. Do not send an upstream task ID.

prompt
string

Draft stage: text instructions, up to 30000 characters; required unless media is provided. Final stage: not allowed (reused from the draft).

Maximum string length: 30000
image_urls
string[]

Draft stage: reference image URLs, up to 30 images (1-2 images without other media are treated as first/last frames). Final stage: not allowed.

Maximum array length: 30
video_urls
string[]

Draft stage: reference video URLs, up to 10 videos. When videos are present, billing adds the total input-video duration. Final stage: not allowed.

Maximum array length: 10
audio_urls
string[]

Draft stage: reference audio URLs, up to 10 audios; audio needs at least one image or video reference. Final stage: not allowed.

Maximum array length: 10
duration
enum<integer>
default:4

Draft stage: output duration in seconds, 4-30 (default 4); duration=-1 is not supported. Final stage: not allowed - the draft duration is reused and billed.

Available options:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
Required range: 4 <= x <= 30
aspect_ratio
enum<string>
default:adaptive

Draft stage: output aspect ratio (default adaptive). Final stage: not allowed (reused from the draft).

Available options:
adaptive,
969,
243,
61,
184,
556,
1269
resolution
enum<string>

Draft previews support only 480p (filled in when omitted). Final videos created with draft_task_id support only 1080p (filled in when omitted).

Available options:
480p,
1080p
generate_audio
boolean
default:true

Draft stage: whether to generate synchronized audio (default true). Final stage: not allowed (reused from the draft).

output_format
enum<string>
default:mp4

Output container format, mp4 (default) or mov. Allowed in both stages.

Available options:
mp4,
mov

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