curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast",
"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": 4,
"resolution": "720p",
"aspect_ratio": "16:9"
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}Create a Veo video
Create Veo 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 |
|---|---|---|---|---|---|
veo-3.1-fast | 720p / 1080p | 4, 6, or 8 seconds (default: 8) | Vincent, first frame, first and last frame, up to 3 picture references | Always generated, cannot be turned off | Unified entrance that does not support video input/extension |
veo-3.1-quality | 720p / 1080p | 4, 6, or 8 seconds (default: 8) | Vincent, first frame, first and last frame, up to 3 picture references | Always generated, cannot be turned off | Unified entry for video input/extension is not supported |
veo-3.1-lite | 720p / 1080p | 4, 6, or 8 seconds (default: 8) | Vincent, first frame, first and last frame; does not support ordinary reference picture mode | Always generated, cannot be turned off | Unified entrance of video input/extension is not supported |
Source: Google Veo 3.1 API. Durations of 4 or 6 seconds require 720p; 1080p or ordinary reference-image mode requires 8 seconds.
curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast",
"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": 4,
"resolution": "720p",
"aspect_ratio": "16:9"
}
'{
"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 Veo video task. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.
Veo model ID.
veo-3.1-fast, veo-3.1-quality, veo-3.1-lite Video generation or editing prompt words.
1Video duration: 4, 6, or 8 seconds. Defaults to 8. Durations of 4 or 6 seconds require 720p; 1080p or ordinary reference-image mode requires 8 seconds.
4, 6, 8 Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.
16:9, 9:16 Output resolution. Available values for different models or modes are shown in the model capabilities table.
720p, 1080p The first frame or the last frame reference picture; at most one of the same type.
2Maximum 3 reference images. Veo 3.1 Lite does not support normal reference image mode; please use frame_images for the first and last frames.
3Hide child attributes
Hide child attributes
Image URL string.
1Optional. Material type; if provided, must be consistent with the corresponding URL field.
image_url Material usage. When omitted, normal reference material is inferred from the URL field.
reference_image User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.
^https://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"