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
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}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.
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
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
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.
Seedance model ID.
seedance-2.5, seedance-2.0, seedance-2.0-mini Video generation or editing prompt words.
1Video 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.
-1 <= x <= 30Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 Output resolution. Available values for different models or modes are shown in the model capabilities table.
480p, 720p, 1080p, 4K The first frame or the last frame reference picture; at most one of the same type.
2Full 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.
50- Option 1
- Option 2
- Option 3
Hide child attributes
Hide child attributes
Image URL string.
1Optional. Material type; if provided, must be consistent with the corresponding URL field.
image_url, video_url, audio_url Material usage. When omitted, normal reference material is inferred from the URL field.
reference_image, reference_video, reference_audio, source_video, first_clip Video URL string.
1Audio URL string.
1Preset patch ID; only used by some models that support patch references.
1Supports audio generation; whether it is enabled by default is determined by the model and upstream account configuration.
Random seed. Fixed seeds can only improve reproducibility, but do not guarantee that the output will be completely consistent.
-1 <= x <= 2147483647User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.
^https://Seedance upstream extension parameters.
Hide child attributes
Hide child attributes
Whether to fix the camera.
Whether to add watermark.
Whether to return the last frame in the result.
Fully modal reference task type; editing and extension are set automatically by the gateway.
auto, reference, edit, extend mp4, mov default, flex 0 <= x <= 9Response
POST /v1/videos Response parameters after the video task is successfully created. The interface returns HTTP 202.
The unique identifier of the video generation task, used for subsequent query of task status.
1"9552de3d-171f-4cca-b492-7baa56523239"
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.
pending, queue "queue"
Video task query address, the client can poll the task status through GET request.
^https://"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"