curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.0-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.0-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedance 2.0

Seedance 2.0 Complete Parameter Guide

Complete parameter reference for Seedance 2.0. Use model to select a model in this folder. Required fields, input requirements, and billing rules are listed for each mode.

Model ID	Mode	Required fields (excluding model)
`seedance-2.0-text-to-video`	Text-to-Video	`prompt`
`seedance-2.0-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.0-reference-to-video`	Reference-to-Video	`prompt`

Text-to-Video

Generate videos from text prompts, supports web search for enhanced timeliness

Image-to-Video

Input 1 image for first-frame video generation, input 2 images for first-last-frame video generation, the model determines automatically

Reference-to-Video

Input reference images (0–9) + reference videos (0–3) + reference audio (0–3) + text prompt to generate video
Supports various creative scenarios including new generation, video editing, and video extension
Now supports AIGC realistic human materials
Asynchronous processing mode, use the returned task ID to query status
Generated video links are valid for 24 hours, please save them promptly

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.0-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.0-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All endpoints require Bearer Token authentication##

Get API Key:

Visit the API Key Management Page to obtain your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

This page combines the parameters of all modes. Required fields, accepted values, and defaults depend on the selected model; differences are listed by mode below.

model

enum<string>

required

Video generation model name

Model ID	Mode	Required fields (excluding model)
`seedance-2.0-text-to-video`	Text-to-Video	`prompt`
`seedance-2.0-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.0-reference-to-video`	Reference-to-Video	`prompt`

Available options:

seedance-2.0-text-to-video,

seedance-2.0-image-to-video,

seedance-2.0-reference-to-video

Example:

"seedance-2.0-text-to-video"

prompt

string

required

Text-to-Video

Text prompt describing the desired video. Supports both Chinese and English, recommended no more than 500 characters for Chinese or 1000 words for English. Maximum prompt length: 10000 tokens

Note:

This model is text-to-video only and does not support image_urls, video_urls, or audio_urls input

Image-to-Video

Text prompt describing the desired video. Supports both Chinese and English, recommended no more than 500 characters for Chinese or 1000 words for English. Maximum prompt length: 10000 tokens

Note:

This model does not support video_urls or audio_urls input

Reference-to-Video

Text prompt describing the desired video. Supports both Chinese and English, recommended no more than 500 characters for Chinese. Maximum prompt length: 10000 tokens

Details:

When referring to input materials in the prompt, prefer explicit tags such as @image1, @video1, and @audio1 instead of relying only on natural-language references such as "image 1", "video 1", or "audio 1"
Tag numbers follow the order of the corresponding URL array and start at 1: the first image_urls item is @image1, the first video_urls item is @video1, and the first audio_urls item is @audio1
Natural-language numbering may still be understood, but explicit tags provide a clearer mapping between each material and its intended use

Example:

"A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically."

image_urls

string<uri>[]

Applies only to: Image-to-Video, Reference-to-Video

Image-to-Video

Image URL array, 1–2 images

Image count and behavior:

Image Count	Behavior	Role
1 image	First-frame image-to-video	Automatically set as `first_frame`
2 images	First-last-frame image-to-video	1st image → `first_frame`, 2nd image → `last_frame`

Image requirements:

Supported formats: .jpeg, .png, .webp
Aspect ratio (width/height): 0.4 ~ 2.5
Width/height pixels: 300 ~ 6000 px
Max size per image: 30MB
Total request body size must not exceed 64MB
When providing first and last frames, both images can be identical. If aspect ratios differ, the first frame takes priority and the last frame will be automatically cropped to fit
Image URLs must be directly accessible by the server

Reference-to-Video

Reference image URL array, 0–9 images

Role description:

Media Type	Role	Typical Usage
Image	`reference_image`	Style reference, product image, first/last frame (specified via prompt)

Image requirements:

Supported formats: .jpeg, .png, .webp
Aspect ratio (width/height): 0.4 ~ 2.5
Width/height pixels: 300 ~ 6000 px
Max size per image: 30MB
Total request body size must not exceed 64MB, do not use Base64 encoding
Image URLs must be directly accessible by the server

Note: You cannot provide only audio_urls; at least 1 image (image_urls) or 1 video (video_urls) must be included

Maximum array length: 9

Example:

["https://example.com/first-frame.jpg"]

video_urls

string<uri>[]

Applies only to: Reference-to-Video

Reference video URL array, 0–3 videos

Role description:

Media Type	Role	Typical Usage
Video	`reference_video`	Camera movement reference, motion reference, original video for editing/extension

Video requirements:

Supported formats: .mp4, .mov
Resolution: 480p, 720p, 1080p
Duration per video: 2 ~ 15 seconds, max 3 videos, total duration of all videos ≤ 15 seconds
Aspect ratio (width/height): 0.4 ~ 2.5
Width/height pixels: 300 ~ 6000 px
Frame pixels (width × height): 409,600 ~ 2,086,876 (e.g., 640×640 ~ 2206×946)
Max size per video: 50MB
Frame rate: 24 ~ 60 FPS
Total request body size must not exceed 64MB, do not use Base64 encoding
Using video references will increase costs (input video duration is counted in billing)
Video URLs must be directly accessible by the server

Note: You cannot provide only audio_urls; at least 1 image (image_urls) or 1 video (video_urls) must be included

Maximum array length: 3

Example:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

Applies only to: Reference-to-Video

Reference audio URL array, 0–3 clips

Role description:

Media Type	Role	Typical Usage
Audio	`reference_audio`	Background music, sound effects, voice/dialogue reference

Audio requirements:

Supported formats: .wav, .mp3
Duration per clip: 2 ~ 15 seconds, max 3 clips, total duration of all audio ≤ 15 seconds
Max size per clip: 15MB
Total request body size must not exceed 64MB, do not use Base64 encoding
Audio URLs must be directly accessible by the server

Note: Audio cannot be provided alone; at least 1 reference video or image must be included

Maximum array length: 3

Example:

["https://example.com/bgm.mp3"]

duration

integer

default:5

Text-to-Video / Image-to-Video

Video duration (seconds), defaults to 5 seconds

Details:

Supports any integer value between 4–15 seconds
Duration directly affects billing

Reference-to-Video

Output video duration (seconds), defaults to 5 seconds

Details:

Supports any integer value between 4–15 seconds
Duration directly affects billing

Required range: 4 <= x <= 15

Example:

8

quality

enum<string>

default:720p

Video resolution, defaults to 720p

Options:

480p: Lower clarity, lower cost
720p: Standard clarity, this is the default
1080p: Ultra HD clarity
4k: 4K Ultra HD clarity

Available options:

480p,

720p,

1080p,

4k

Example:

"720p"

aspect_ratio

enum<string>

default:adaptive

Text-to-Video

Video aspect ratio, defaults to adaptive

Options:

16:9 (landscape), 9:16 (portrait), 1:1 (square), 4:3, 3:4, 21:9 (ultrawide)
adaptive: The model intelligently selects the best aspect ratio based on the prompt

Pixel values per resolution:

Aspect Ratio	480p	720p	1080p	4K
16:9	864×496	1280×720	1920×1080	3840×2160
4:3	752×560	1112×834	1664×1248	3326×2494
1:1	640×640	960×960	1440×1440	2880×2880
3:4	560×752	834×1112	1248×1664	2494×3326
9:16	496×864	720×1280	1080×1920	2160×3840
21:9	992×432	1470×630	2206×946	4398×1886

Image-to-Video

Video aspect ratio, defaults to adaptive

Options:

16:9 (landscape), 9:16 (portrait), 1:1 (square), 4:3, 3:4, 21:9 (ultrawide)
adaptive: Automatically selects the closest aspect ratio based on the first-frame image proportions

Pixel values per resolution:

Aspect Ratio	480p	720p	1080p	4K
16:9	864×496	1280×720	1920×1080	3840×2160
4:3	752×560	1112×834	1664×1248	3326×2494
1:1	640×640	960×960	1440×1440	2880×2880
3:4	560×752	834×1112	1248×1664	2494×3326
9:16	496×864	720×1280	1080×1920	2160×3840
21:9	992×432	1470×630	2206×946	4398×1886

Reference-to-Video

Video aspect ratio, defaults to adaptive

Options:

16:9 (landscape), 9:16 (portrait), 1:1 (square), 4:3, 3:4, 21:9 (ultrawide)
adaptive: Determined based on prompt intent, priority: video > image > prompt

Pixel values per resolution:

Aspect Ratio	480p	720p	1080p	4K
16:9	864×496	1280×720	1920×1080	3840×2160
4:3	752×560	1112×834	1664×1248	3326×2494
1:1	640×640	960×960	1440×1440	2880×2880
3:4	560×752	834×1112	1248×1664	2494×3326
9:16	496×864	720×1280	1080×1920	2160×3840
21:9	992×432	1470×630	2206×946	4398×1886

Available options:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

Example:

"16:9"

generate_audio

boolean

default:true

Text-to-Video

Whether to generate synchronized audio, defaults to true

Options:

true: Video includes synchronized audio (voice, sound effects, background music) at no additional charge. It is recommended to place dialogue within double quotes to optimize audio generation
false: Output silent video

Image-to-Video / Reference-to-Video

Whether to generate synchronized audio, defaults to true

Options:

true: Video includes synchronized audio at no additional charge
false: Output silent video

Example:

true

content_filter

boolean

default:true

Content filter, enabled by default true

Options:

true: Standard content safety check, this is the default
false: Relaxes content restrictions, billed at +10% (1.1x). Illegal and prohibited content is always enforced regardless of this setting

Mutually exclusive with web search:

content_filter: false and model_params.web_search: true cannot be used together; sending both returns a 400 parameter error
Keep content_filter: true (the default) when web search is needed

Example:

true

model_params

object

Applies only to: Text-to-Video

Model extension parameters

Show child attributes

callback_url

string<uri>

HTTPS callback URL for task completion

Callback timing:

Triggered when the task is completed, failed, or cancelled
Sent after billing confirmation is complete

Security restrictions:

Only HTTPS protocol is supported
Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback mechanism:

Timeout: 10 seconds
Up to 3 retries after failure (at 1/2/4 seconds after failure respectively)
Callback response body format is consistent with the task query endpoint response format
A 2xx status code is considered successful; other status codes trigger retries

Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video generation task created successfully

created

integer

Task creation timestamp

Example:

1761313744

string

Task ID

Example:

"task-unified-1774857405-abc123"

model

string

Actual model name used

Example:

"seedance-2.0-text-to-video"

object

enum<string>

Specific type of the task

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Video task details

Show child attributes

type

enum<string>

Output type of the task

Available options:

text,

image,

audio,

video

Example:

"video"

usage

object

Usage and billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Seedance 2.0 Complete Parameter Guide

Text-to-Video

Image-to-Video

Reference-to-Video

Authorizations

Body

Response