Skip to main content
POST
cURL

Key Parameters and Limits

Seedance 2.5 Lite Image to Video animates a first frame (and optionally a last frame) into a 4–30 second clip with native audio. It shares the full 2.5 contract with the discount routes and differs only in billing tier and resolution: special-offer billing, 720p-only output.
  • Image input: First frame via image_url / image_urls, with an optional last frame — at most 2 images per request.
  • Image formats: jpeg, png, webp, bmp, tiff, gif, heic, and heif; each image under 30 MB; aspect ratio range (0.4, 2.5); width and height range (300px, 6000px).
  • Text prompt: For Chinese, keep it under 500 characters; for English, under 1,000 words.
  • Duration: 4–30 seconds per clip (default 4s).
  • Resolution: 720p only — 480p, 1080p, 2K and 4K are not supported on this route.
  • Aspect ratio: adaptive (default), 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.
  • Native audio: generated with the picture and on by default (generate_audio=true); disable per request if not needed.
Special-offer billing applies and only successful tasks are charged — see the pricing page for live rates. This is a full-capability route: media URLs are submitted to the asset review service before the task is submitted by default (real_person=true); set real_person=false only when the materials are confirmed face-free to pass media URLs through as-is, so plain public URLs always work in requests.

Real-person review (real_person)

When a request carries reference materials, the boolean real_person field controls whether materials are submitted to face review first:
  • real_person: true (default): materials are submitted to the asset review service first, and the task is created with assetId://{assetId} references; the task waits during review and fails if review rejects the materials.
  • real_person: false: review is skipped and material URLs are passed through to task creation as-is.
Set it to false only when the materials are confirmed face-free to save the review round trip; keep the default true for materials containing real people.

Asset library references

Besides publicly accessible URLs, the image_url / image_urls, video_urls, and audio_url / audio_urls fields also accept asset library references in the form assetId://{assetId}. Asset IDs are shared across the platform: any account may reference a known assetId, regardless of who submitted it — the same sharing semantics as a public URL. Only ACTIVE assets pass validation. Submit and track assets via asset upload and asset detail.

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-lite-i2v"
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[]

First frame image URL; a second URL is used as the last frame constraint. 1 to 2 images are supported.

Required array length: 1 - 2 elements
duration
enum<integer>
default:4

Video duration in seconds, from 4 to 30.

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
resolution
enum<string>
default:720p

Generate video resolution.

Available options:
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.

real_person
boolean
default:true

Whether the reference materials contain real people (human faces). Defaults to true: materials are submitted to the asset review service and replaced with assetId:// references before task creation. Set to false only when the materials are confirmed face-free to skip review and pass material URLs through as-is.

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