Seedance 2.0 V2V - Modellix

curl --request POST \ --url https://api.modellix.ai/api/v1/bytedance/seedance-2.0-v2v \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "video_urls": [ "https://example.com/ref.mp4" ] } '

{ "code": 0, "message": "success", "data": { "status": "pending", "task_id": "task-abc123", "model_id": "model-123", "get_result": { "method": "GET", "url": "https://api.modellix.ai/api/v1/tasks/task-abc123" } } }

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Seedance 2.0 video-to-video request. Official supported combinations are cumulative (not mutually exclusive): video_urls is always required; optionally add prompt, reference_images, and/or audio_urls. First/last frame parameters are not supported on V2V.

video_urls

string[]

required

Required. One to three reference video URLs.

Required array length: 1 - 3 elements

Video URL.

Minimum string length: 1

prompt

string

Optional. Video description. Maximum 10000 characters. Use [Image n], [Video n], and [Audio n] placeholders when referencing optional inputs. Recommended prompt length: under 1000 words.

Required string length: 1 - 10000

reference_images

string[]

Optional. Up to 9 reference image URLs for style or content guidance. Use [Image n] placeholders in prompt.

Required array length: 1 - 9 elements

Image URL or Base64 data.

Minimum string length: 1

audio_urls

string[]

Optional. Up to 3 reference audio URLs. Use [Audio n] placeholders in prompt.

Required array length: 1 - 3 elements

Audio URL.

Minimum string length: 1

ratio

enum<string>

default:16:9

Aspect ratio of the generated video.

Available options:

21:9,

16:9,

4:3,

1:1,

3:4,

9:16

resolution

enum<string>

default:720p

Output resolution of the video.

Available options:

480p,

720p,

1080p,

4k

duration

enum<integer>

default:5

Video duration in seconds (4-15 seconds).

Available options:

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

seed

integer

default:-1

Random seed for reproducible generation. Use -1 for random.

Required range: -1 <= x <= 4294967295

camera_fixed

boolean

default:false

Whether to keep the camera fixed during generation.

generate_audio

boolean

default:true

Whether to generate audio.

execution_expires_after

integer

default:172800

Task expiration time in seconds.

Required range: 3600 <= x <= 259200

return_last_frame

boolean

default:false

Whether to return the last frame of the generated video.

Response

200 - application/json

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes