curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "flux-3-video",
"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 FLUX 3 Video videos
Create FLUX 3 Video 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 |
|---|---|---|---|---|---|
flux-3-video | HD / FHD (unified field mapping 480p/720p → HD, 1080p → FHD) | 5–20 seconds or auto | Vincent, 1–10 keyframes, video continuation, draft enhancement | Supported, enabled by default | Normal audio/video style reference not supported |
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": "flux-3-video",
"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 FLUX 3 Video video task. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.
FLUX 3 Video Model ID.
flux-3-video Video generation or editing prompt words.
1An integer of 5–20 seconds, or auto to let the model determine the duration based on content.
5 <= x <= 20Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.
auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 Output resolution. Available values for different models or modes are shown in the model capabilities table.
480p, 720p, 1080p First/last frame shortcut. For more untimed keyframes, pass 1–10 reference_image entries in input_references. To set a timestamp, use role=keyframe with seconds, or pass native keyframes in extra_body.keyframes.
2Image-to-video accepts 1–10 untimed reference_image entries or timed keyframe entries with seconds, mapped to [seconds, image URL]. Do not mix timed and untimed images. Video continuation requires exactly one source_video or first_clip.
10- Option 1
- Option 2
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 Material usage. When omitted, normal reference material is inferred from the URL field.
reference_image, keyframe, source_video, first_clip Video URL string.
1Required for role=keyframe; target timestamp in seconds.
x >= 0Whether to generate synchronized audio, the default is true.
User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.
^https://FLUX 3 Video native extension parameters.
Hide child attributes
Hide child attributes
text_to_video, image_to_video, video_to_video, draft_enhance 1–10 images, or timed keyframes arranged by [seconds, image URL].
Video continuation input.
Cache URL or Base64 required for draft enhancement.
latest 0 <= x <= 4Whether to generate a low-cost HD draft first.
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"