Create a Seedance video

Create Seedance video tasks via unified POST /v1/videos. Model capabilities are subject to the actual callable range of the current Tikway gateway.

Model	Resolution	Duration	Supported Modes	Audio	Reference Limitations
seedance-2.5	480p / 720p / 1080p	4–30 seconds; edit/extend available -1 smart duration	Visibility, first frame, first and last frame, full-modal reference, edit, extend	Supported	Up to 50 reference items
seedance-2.0	480p / 720p / 1080p / 4K	4–15 seconds; edit/extend available -1 smart duration	Visibility, first frame, first and last frame, full-modal reference, edit, extend	Supported	Up to 15 reference items
seedance-2.0-mini	480p / 720p	4–15 seconds	Vincent, first frame, first and last frame	Supported	Does not support full-modal referencing, editing or extension

Source: Volcan Ark Video Generation API. The difference between the official website capabilities and the current unopened capabilities of the gateway can be found in this audit report.

POST https://api.tikway.ai/v1/videos

cURL

Text to video

curl --request POST \ --url https://api.tikway.ai/v1/videos \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "seedance-2.5", "prompt": "A golden retriever runs on the beach at sunset. The camera follows smoothly, and the picture has a natural and delicate film quality.", "duration": 8, "resolution": "1080p", "aspect_ratio": "16:9", "generate_audio": true } '

202

{
  "id": "9552de3d-171f-4cca-b492-7baa56523239",
  "status": "pending",
  "polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a Seedance video task. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.

model · enum<string> · required

Seedance model ID.

Available options: seedance-2.5, seedance-2.0, seedance-2.0-mini

prompt · string

Video generation or editing prompt words.

Minimum string length: 1

duration · integer string

Video duration (seconds). 2.0 Mini is 4–15; 2.0 is 4–15; 2.5 is 4–30. When editing or extending a task, you can pass -1 to let the model determine the duration based on the input material.

Required range: -1 <= x <= 30

aspect_ratio · enum<string>

Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.

Available options: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9

resolution · enum<string>

Output resolution. Available values ​​for different models or modes are shown in the model capabilities table.

Available options: 480p, 720p, 1080p, 4K

frame_images · object[]

The first frame or the last frame reference picture; at most one of the same type.

Maximum array length: 2

Hide child attributes

frame_images. type · enum<string> · required

Reference frame position.

Available options: first_frame, last_frame

frame_images. image_url · string<uri> · required

Reference image URL string.

Minimum string length: 1

input_references · object[]

Full modal reference material. 2.0 Mini is not supported; 2.0 has a maximum of 15 items; 2.5 has a maximum of 50 items. Reference mode cannot be mixed with first and last frame modes.

Maximum array length: 50

Option 1

Option 2

Option 3

Hide child attributes

input_references. image_url · string<uri> · required

Image URL string.

Minimum string length: 1

input_references. type · enum<string>

Optional. Material type; if provided, must be consistent with the corresponding URL field.

Available options: image_url, video_url, audio_url

input_references. role · enum<string>

Material usage. When omitted, normal reference material is inferred from the URL field.

Available options: reference_image, reference_video, reference_audio, source_video, first_clip

input_references. video_url · string<uri>

Video URL string.

Minimum string length: 1

input_references. audio_url · string<uri>

Audio URL string.

Minimum string length: 1

input_references. reference_voice · string

Preset patch ID; only used by some models that support patch references.

Minimum string length: 1

generate_audio · boolean

Supports audio generation; whether it is enabled by default is determined by the model and upstream account configuration.

seed · integer

Random seed. Fixed seeds can only improve reproducibility, but do not guarantee that the output will be completely consistent.

Required range: -1 <= x <= 2147483647

callback_url · string<uri>

User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.

Pattern: ^https://

extra_body · object

Seedance upstream extension parameters.

Hide child attributes

extra_body. camera_fixed · boolean

Whether to fix the camera.

extra_body. watermark · boolean

Whether to add watermark.

extra_body. return_last_frame · boolean

Whether to return the last frame in the result.

extra_body. omni_reference_task_type · enum<string>

Fully modal reference task type; editing and extension are set automatically by the gateway.

Available options: auto, reference, edit, extend

extra_body. output_format · enum<string> · default: mp4

Available options: mp4, mov

extra_body. service_tier · enum<string>

Available options: default, flex

extra_body. priority · integer

Required range: 0 <= x <= 9

Response

202 - application/json

POST /v1/videos Response parameters after the video task is successfully created. The interface returns HTTP 202.

id · string · required

The unique identifier of the video generation task, used for subsequent query of task status.

Minimum string length: 1

Example:

"9552de3d-171f-4cca-b492-7baa56523239"

status · enum<string> · required

Task creation status. pending means that the task has been created and is waiting for submission; queue means that the task has entered the generation queue.

Available options: pending, queue

Example:

"queue"

polling_url · string<uri> · required

Video task query address, the client can poll the task status through GET request.

Pattern: ^https://

Example:

"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"