curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan-3.0",
"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 Wan video
Create Wan 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 |
|---|---|---|---|---|---|
wan-3.0 | 480p / 720p / 1080p | 2–30 seconds or -1 smart duration | Vincent, first frame, first and last frame, full-modal reference | Supported, enabled by default | 10 images / 5 videos / 5 audios; you can also upload 1 file or link |
wan-2.7 | 720p / 1080p | Generate 2–15 seconds; reference/edit 2–10 seconds | Vincent, first frame, first and last frame, continuation, reference, edit | Support | Mode related |
wan-2.6 | 720p / 1080p | Generate 2–15 seconds; reference 2–10 seconds | Vincent, first frame, reference; first and last frames/edit using compatible model | Supported; compatibility mode may be silent | Reference raw video 1–5 images/videos |
Source: Alibaba Cloud Video Generation Model Overview. 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": "wan-3.0",
"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 Wan video task. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.
Wan model ID.
wan-3.0, wan3.0-video, wan-2.7, wan-2.6 Video generation or editing prompt words.
1Wan 2.6/2.7 available. Wan 3.0 does not support top-level negative_prompt; if the upstream extension supports it, please put extra_body.
Only wan-2.6 supports precise pixel dimensions; use resolution + aspect_ratio for other Wan models.
^[1-9][0-9]*[x*][1-9][0-9]*$Video duration (seconds). Wan 3.0 is 2–30 or -1; the upper limit of Wan 2.7/2.6 changes with the generation mode, see the model capability table for details.
-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 Output resolution. Available values for different models or modes are shown in the model capabilities table.
480p, 720p, 1080p The first frame or the last frame reference picture; at most one of the same type.
2Wan reference material. Different models and modes have different quantity limits; the reference material of Wan 3.0 cannot be mixed with the first and last frames, and file and link are mutually exclusive.
21- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
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, file_url, link_url Material usage. When omitted, normal reference material is inferred from the URL field.
reference_image, reference_video, reference_audio, source_video, first_clip, driving_audio, file, link Video URL string.
1Audio URL string.
1File URL string.
1Web page URL string.
1Preset patch ID; only used by some models that support patch references.
1Whether to generate audio. Wan 3.0 is enabled by default; the specific behavior of Wan 2.6/2.7 is determined by the mode.
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://Alibaba Cloud Bailian video model expansion parameters. Fields are merged into upstream parameters.
Hide child attributes
Hide child attributes
Whether to enable prompt word rewriting.
Single lens or multiple lenses.
single, multi Whether to add watermark.
Audio processing during video editing.
auto, origin Response
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"