Skip to main content
POST
cURL
This is the Seedance Video Generation API edit video endpoint. Edit based on reference video, supports delete, replace, modify operations. All 4 models supported. Submit async task and return id, use query endpoint to get results.
Usage: Include text (edit instruction) and video_url (role=reference_video, video to edit) in content, set omni_reference_task_type: “edit”. ratio must be adaptive, duration must be -1.

Authorizations

TT-API-KEY
string
header
required

Get your API key from the TTAPI Dashboard.

Body

application/json
model
enum<string>
required

Model ID

Available options:
doubao-seedance-2-5-260628,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
doubao-seedance-2-0-mini-260615
content
object[]
required

Input content list. Must include text (edit instruction) and at least one video_url (reference_video)

Input content item

omni_reference_task_type
enum<string>
required

Task type, fixed as edit (video editing)

Available options:
edit
ratio
enum<string>
required

Video aspect ratio, must be adaptive (auto-matches the video being edited)

Available options:
adaptive
duration
enum<integer>
required

Video duration, must be -1 (model auto-matches duration of the video being edited, ~0.4s error)

Available options:
-1
generate_audio
boolean
default:true

Whether to generate synchronized audio

output_format
enum<string>
default:mp4

Output format. mov recommended for video editing scenarios (high color accuracy)

Available options:
mp4,
mov
watermark
boolean
default:false

Whether to add watermark

return_last_frame
boolean
default:false

Whether to return last frame image

callback_url
string

Callback URL

execution_expires_after
integer
default:172800

Task timeout threshold (seconds). Range [3600, 259200]

priority
integer
default:0

Execution priority. Range [0, 9]

safety_identifier
string

End user identifier, max 64 characters

tools
object[]

Tool configuration

service_tier
enum<string>
default:default

Service tier

Available options:
default

Response

200 - application/json

Task submitted successfully

id
string
required

Task ID

Last modified on October 22, 2026