curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-text-to-video",
  "prompt": "Une bille de verre roule rapidement sur une piste en bois, puis tombe dans l’eau en éclaboussant.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "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-1.2-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 1.2 Flash

Gemini Omni 1.2 Flash – Vue d’ensemble des paramètres

Gemini Omni 1.2 Flash propose six types de tâches via POST /v1/videos/generations.
Texte vers vidéo : gemini-omni-1.2-flash-text-to-video ; seul un prompt textuel est requis ; 3–15 secondes.
Image vers vidéo : gemini-omni-1.2-flash-image-to-video ; une image initiale (3–15 secondes) ou des images initiale et finale (3–10 secondes).
Références vers vidéo : gemini-omni-1.2-flash-reference-to-video ; images de référence et jusqu’à 3 vidéos de référence. Si duration dépasse 10 secondes, au maximum 1 vidéo de référence.
Montage : gemini-omni-1.2-flash-video-edit ; 1 vidéo de 15 secondes maximum et, en option, jusqu’à 10 images de référence. quality vaut auto par défaut.
Extension : gemini-omni-1.2-flash-video-extend ; 1 vidéo de 30 secondes maximum et, en option, jusqu’à 10 images de référence. quality vaut auto par défaut ; duration désigne les secondes ajoutées.
Augmentation de résolution : gemini-omni-1.2-flash-video-upscale ; 1 vidéo de 15 secondes maximum aux dimensions standard prises en charge. Résolution cible via quality ; aucun prompt requis.
Format d’image : auto par défaut. Le montage, l’extension et l’augmentation de résolution conservent le format d’entrée.
Audio natif synchronisé généré automatiquement, sans option supplémentaire.
Fixez seed pour améliorer la reproductibilité.
Traitement asynchrone : consultez la tâche avec l’identifiant renvoyé.
Les liens vidéo sont valables 24 heures ; enregistrez les résultats rapidement.

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-text-to-video",
  "prompt": "Une bille de verre roule rapidement sur une piste en bois, puis tombe dans l’eau en éclaboussant.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "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-1.2-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"
  }
}

Autorisations

Authorization

string

header

requis

##Toutes les interfaces necessitent une authentification par Bearer Token##

Obtenir une cle API :

Rendez-vous sur la page de gestion des cles API pour obtenir votre cle API

Ajoutez ceci dans l'en-tete de la requete lors de l'utilisation :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

requis

Nom du modèle. Sélectionnez l’identifiant adapté aux données d’entrée et à la tâche :

gemini-omni-1.2-flash-text-to-video : texte vers vidéo
gemini-omni-1.2-flash-image-to-video : image vers vidéo (image initiale ou images initiale et finale)
gemini-omni-1.2-flash-reference-to-video : références vers vidéo
gemini-omni-1.2-flash-video-edit : montage vidéo
gemini-omni-1.2-flash-video-extend : extension vidéo
gemini-omni-1.2-flash-video-upscale : augmentation de la résolution vidéo

Options disponibles:

gemini-omni-1.2-flash-text-to-video,

gemini-omni-1.2-flash-image-to-video,

gemini-omni-1.2-flash-reference-to-video,

gemini-omni-1.2-flash-video-edit,

gemini-omni-1.2-flash-video-extend,

gemini-omni-1.2-flash-video-upscale

Exemple:

"gemini-omni-1.2-flash-text-to-video"

prompt

string

Prompt textuel décrivant la génération, le montage ou la continuation souhaitée ; chinois et anglais pris en charge. Obligatoire sauf pour l’augmentation de résolution, qui ne nécessite aucun prompt.

Décrivez clairement le sujet, l’action, la scène, les mouvements de caméra et les éléments à conserver.
Placez les contraintes négatives dans le prompt, comme No dialogue ou Aucun texte. Il n’existe pas de paramètre de prompt négatif séparé.

L’augmentation de résolution vidéo n’utilise pas prompt ; tout prompt fourni est ignoré.

Exemple:

"Une bille de verre roule rapidement sur une piste en bois, puis tombe dans l’eau en éclaboussant."

image_urls

string<uri>[]

Tableau d’images d’entrée.

Image vers vidéo : obligatoire, 1 à 2 images. Une définit le début ; deux définissent le début et la fin.
Références vers vidéo : obligatoire ; maximum publiquement recommandé de 10 images de référence.
Montage : facultatif, jusqu’à 10 images de référence.
Extension : facultatif, jusqu’à 10 images de référence.
Texte vers vidéo et augmentation de résolution : aucune image d’entrée acceptée.

URL HTTP/HTTPS uniquement ; formats : png, jpeg, webp.

Required array length: 1 - 10 elements

Exemple:

[
  "https://example.com/character.png",
  "https://example.com/scene.png"
]

video_urls

string<uri>[]

Tableau de vidéos d’entrée.

Références vers vidéo : facultatif ; maximum publiquement recommandé de 3 vidéos. Si duration dépasse 10 secondes, au maximum 1.
Montage : exactement 1 vidéo obligatoire, de 15 secondes maximum.
Extension : exactement 1 vidéo obligatoire, de 30 secondes maximum.
Augmentation de résolution : exactement 1 vidéo obligatoire, de 15 secondes maximum. Dimensions : 640×360, 1280×720, 1920×1080 et leurs équivalents en portrait uniquement.
Texte vers vidéo et image vers vidéo : aucune vidéo d’entrée acceptée.

Chaque vidéo de référence doit durer au maximum 10 secondes.

Required array length: 1 - 3 elements

Exemple:

["https://example.com/reference.mp4"]

quality

enum<string>

Résolution vidéo.

Valeurs (paysage / portrait) :

360p : 640×360 / 360×640
720p : 1280×720 / 720×1280
1080p : 1920×1080 / 1080×1920
4k : 3840×2160 / 2160×3840
auto : montage et extension uniquement ; suit la résolution d’entrée.

Valeurs par défaut :

Texte vers vidéo, image vers vidéo, références vers vidéo : 720p.
Montage et extension : auto.
Augmentation de résolution : cible obligatoire et supérieure à l’entrée. 360p → 720p ou 1080p ; 720p → 1080p ou 4k ; 1080p → 4k.

Facturation : La génération de texte en vidéo, d’image en vidéo et à partir de références, le montage et la prolongation sont facturés séparément selon les tokens d’entrée, les tokens vidéo de sortie et les autres tokens de sortie (y compris ceux de raisonnement). L’augmentation de résolution ne facture que les tokens vidéo de sortie, sans frais pour les tokens d’entrée ou de raisonnement. Le montant à la soumission est une estimation ; la facturation finale repose sur l’utilisation réelle.

Options disponibles:

360p,

720p,

1080p,

4k,

auto

Exemple:

"720p"

duration

Durée vidéo.

Texte vers vidéo et références vers vidéo : entier de 3 à 15 secondes ; par défaut 3.
Image vers vidéo : 3–15 secondes avec une image initiale, 3–10 avec les images initiale et finale ; par défaut 3.
Montage et augmentation de résolution : uniquement auto, également la valeur par défaut. La durée suit l’entrée.
Extension : entier de 3 à 10 secondes ; par défaut 3. Il s’agit de la durée ajoutée.

Plage requise: 3 <= x <= 15

Exemple:

3

aspect_ratio

enum<string>

défaut:auto

Format d’image de la vidéo ; par défaut auto.

16:9 : paysage.
9:16 : portrait.
auto : choisi par le modèle selon le prompt et les données d’entrée ; valeur par défaut.

Le montage, l’extension et l’augmentation de résolution n’acceptent que auto et conservent le format d’entrée.

Options disponibles:

16:9,

9:16,

auto

Exemple:

"auto"

seed

integer

Graine aléatoire, choisie aléatoirement par défaut. Plage : 0–4294967295. Fixer la graine réduit les variations lors de l’ajustement des paramètres du prompt et améliore la reproductibilité.

Plage requise: 0 <= x <= 4294967295

Exemple:

42

callback_url

string<uri>

Adresse de rappel HTTPS a la fin de la tache

Moment du rappel :

Declenche lorsque la tache est terminee (completed), a echoue (failed) ou est annulee (cancelled)
Envoye apres confirmation de la facturation

Restrictions de securite :

Prend en charge uniquement le protocole HTTPS
Les rappels vers des adresses IP de reseau interne sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne depasse pas 2048 caracteres

Mecanisme de rappel :

Delai d'expiration : 10 secondes
Jusqu'a 3 tentatives apres echec (les tentatives ont lieu respectivement 1 seconde / 2 secondes / 4 secondes apres l'echec)
Le format du corps de rappel est identique a celui renvoye par l'interface de requete de tache
L'adresse de rappel est consideree comme reussie si elle renvoie un code de statut 2xx ; les autres codes declenchent une nouvelle tentative

Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tache video creee avec succes

created

integer

Horodatage de creation de la tache

Exemple:

1757169743

string

ID de la tache

Exemple:

"task-unified-1757169743-7cvnl5zw"

model

string

Nom du modele reellement utilise

Exemple:

"gemini-omni-1.2-flash-text-to-video"

object

enum<string>

Type specifique de la tache

Options disponibles:

video.generation.task

progress

integer

Pourcentage de progression de la tache (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

État de la tâche. Le point de terminaison de création renvoie toujours processing ; l’état interne pending est également présenté aux clients comme processing.

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"processing"

task_info

object

Informations detaillees sur la tache video

Show child attributes

type

enum<string>

Type de sortie de la tache

Options disponibles:

text,

image,

audio,

video

Exemple:

"video"

usage

object

Informations d'usage et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Gemini Omni 1.2 Flash – Vue d’ensemble des paramètres

Autorisations

Corps

Réponse