curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-flash-text-to-video",
"prompt": "A glass marble rolls rapidly down a wooden track and finally drops into water with a splash",
"aspect_ratio": "16:9",
"duration": 10
}
'import requests
url = "https://api.evolink.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-flash-text-to-video",
"prompt": "A glass marble rolls rapidly down a wooden track and finally drops into water with a splash",
"aspect_ratio": "16:9",
"duration": 10
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'gemini-omni-flash-text-to-video',
prompt: 'A glass marble rolls rapidly down a wooden track and finally drops into water with a splash',
aspect_ratio: '16:9',
duration: 10
})
};
fetch('https://api.evolink.ai/v1/videos/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evolink.ai/v1/videos/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gemini-omni-flash-text-to-video',
'prompt' => 'A glass marble rolls rapidly down a wooden track and finally drops into water with a splash',
'aspect_ratio' => '16:9',
'duration' => 10
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evolink.ai/v1/videos/generations"
payload := strings.NewReader("{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evolink.ai/v1/videos/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evolink.ai/v1/videos/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}"
response = http.request(request)
puts response.read_body{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "gemini-omni-flash-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 60
},
"type": "video",
"usage": {
"billing_rule": "per_token",
"credits_reserved": 102.34,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: gemini-omni-flash-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Gemini Omni Flash 1.0 Text-to-Video
- The Gemini Omni Flash (gemini-omni-flash-text-to-video) model supports text-to-video mode, producing a video with native audio from a text prompt
- Duration control: Set an integer duration of
3~10seconds viaduration, or passautoto let the model decide - Aspect ratio: Choose
16:9,9:16, orautoviaaspect_ratio - Native audio: The model automatically generates synchronized audio for the video, no extra parameters required
- Negative description: Write it directly into
prompt(e.g.No dialogue); this model does not provide a separate negative prompt parameter - Asynchronous processing mode; use the returned task ID to query the result
- The generated video link is valid for 24 hours, please save it promptly
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-flash-text-to-video",
"prompt": "A glass marble rolls rapidly down a wooden track and finally drops into water with a splash",
"aspect_ratio": "16:9",
"duration": 10
}
'import requests
url = "https://api.evolink.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-flash-text-to-video",
"prompt": "A glass marble rolls rapidly down a wooden track and finally drops into water with a splash",
"aspect_ratio": "16:9",
"duration": 10
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'gemini-omni-flash-text-to-video',
prompt: 'A glass marble rolls rapidly down a wooden track and finally drops into water with a splash',
aspect_ratio: '16:9',
duration: 10
})
};
fetch('https://api.evolink.ai/v1/videos/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evolink.ai/v1/videos/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gemini-omni-flash-text-to-video',
'prompt' => 'A glass marble rolls rapidly down a wooden track and finally drops into water with a splash',
'aspect_ratio' => '16:9',
'duration' => 10
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evolink.ai/v1/videos/generations"
payload := strings.NewReader("{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evolink.ai/v1/videos/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evolink.ai/v1/videos/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"gemini-omni-flash-text-to-video\",\n \"prompt\": \"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash\",\n \"aspect_ratio\": \"16:9\",\n \"duration\": 10\n}"
response = http.request(request)
puts response.read_body{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "gemini-omni-flash-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 60
},
"type": "video",
"usage": {
"billing_rule": "per_token",
"credits_reserved": 102.34,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: gemini-omni-flash-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Authorizations
##All endpoints require authentication using a Bearer Token##
Get your API Key:
Visit the API Key management page to obtain your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
Model name, fixed to gemini-omni-flash-text-to-video
gemini-omni-flash-text-to-video "gemini-omni-flash-text-to-video"
Text prompt for video generation, supports both English and Chinese
Usage tips:
- Describe the subject, action, scene, camera movement, etc.; the more specific, the more stable the result
- Write negative requirements directly into the prompt (e.g.
No dialogue,no text on screen); this model does not provide a separate negative prompt parameter
"A glass marble rolls rapidly down a wooden track and finally drops into water with a splash"
Video duration (seconds), default 10
Value notes:
- Integer: range
3 ~ 10seconds auto: the model decides the output duration
Billing note: The actual charge is based on the usage of the generated video
3 <= x <= 106
Video aspect ratio, default 16:9
Value notes:
16:9: landscape9:16: portraitauto: the model decides the aspect ratio
16:9, 9:16, auto "16:9"
HTTPS callback URL to notify when the task completes
Callback timing:
- Triggered when the task completes (completed), fails (failed), or is cancelled (cancelled)
- Sent after billing is confirmed
Security restrictions:
- HTTPS protocol only
- Callbacks to internal IP addresses are forbidden (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback mechanism:
- Timeout:
10seconds - Up to
3retries on failure (retried1s /2s /4s after each failure respectively) - The callback body format matches the response of the task query endpoint
- A 2xx status code from the callback URL is treated as success; other status codes trigger a retry
"https://your-domain.com/webhooks/video-task-completed"
Response
Video task created successfully
Task creation timestamp
1757169743
Task ID
"task-unified-1757169743-7cvnl5zw"
The model name actually used
"gemini-omni-flash-text-to-video"
The specific type of the task
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Detailed video task information
Show child attributes
Show child attributes
The output type of the task
text, image, audio, video "video"
Usage and billing information
Show child attributes
Show child attributes