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-reference-to-video",
  "prompt": "Fais se promener le personnage de l’image de référence dans la scène de référence.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-reference-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-reference-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 Référence vers vidéo

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-reference-to-video) génère une vidéo avec audio natif à partir d’images, de vidéos de référence facultatives et d’un prompt.
Images : image_urls accepte 1 à 10 images pour guider les sujets, le style ou les éléments.
Vidéos : video_urls est facultatif, jusqu’à 3 vidéos pour guider actions, caméra ou style. Si duration dépasse 10 secondes, au maximum 1 vidéo de référence.
Résolution : 360p, 720p, 1080p ou 4k ; par défaut 720p.
Durée : duration, entier de 3 à 15 secondes ; par défaut 3.
Format d’image : 16:9, 9:16 ou auto ; par défaut auto.
Audio natif synchronisé automatique, sans paramètre supplémentaire.
Contraintes négatives directement dans prompt, comme No dialogue ; aucun paramètre séparé.
Fixez seed pour améliorer la reproductibilité.
Traitement asynchrone : consultez la tâche avec l’identifiant renvoyé.
Les liens 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-reference-to-video",
  "prompt": "Fais se promener le personnage de l’image de référence dans la scène de référence.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-reference-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-reference-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>

défaut:gemini-omni-1.2-flash-reference-to-video

requis

Nom du modèle, fixé à gemini-omni-1.2-flash-reference-to-video

Options disponibles:

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

Exemple:

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

prompt

string

requis

Prompt décrivant l’utilisation des références de sujet, style et mouvement.

Prend en charge le chinois et l’anglais. Décrivez clairement les actions et les changements souhaités pour des résultats plus stables. Placez les contraintes négatives dans prompt, comme No dialogue ou Aucun texte ; aucun paramètre de prompt négatif séparé n’est proposé.

Le prompt est obligatoire et ne doit être ni vide ni composé uniquement de caractères d’espacement.

Minimum string length: 1

Pattern: \S

Exemple:

"Un chaton joue avec une pelote de laine en la tapotant avec ses pattes."

image_urls

string<uri>[]

requis

Tableau d'URL d'images de référence. Obligatoire ; de 1 à 10 images pour contraindre le sujet, le style ou les éléments.

Exigences d'entrée :

URL d'image HTTP/HTTPS uniquement
Formats pris en charge : 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 facultatif de vidéos de référence. Jusqu’à 3 vidéos ; si duration dépasse 10 secondes, au maximum 1. Peut être combiné avec image_urls pour guider actions, caméra ou style. URL HTTP/HTTPS de vidéos mp4 uniquement. Facturation : chaque vidéo contribue aux tokens d’entrée selon sa duré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>

défaut:720p

Résolution vidéo ; valeur par défaut 720p.

Valeurs prises en charge :

360p : paysage 640×360 / portrait 360×640
720p : paysage 1280×720 / portrait 720×1280 ; valeur par défaut
1080p : paysage 1920×1080 / portrait 1080×1920
4k : paysage 3840×2160 / portrait 2160×3840

L'orientation dépend de aspect_ratio : 16:9 produit un format paysage et 9:16 un format portrait.

Facturation : Les tokens de sortie augmentent linéairement avec la résolution. Par rapport à 720p, 360p utilise environ un tiers, 1080p environ 1,5× et 4k environ 3×. Le montant réel dépend de l'utilisation générée.

Options disponibles:

360p,

720p,

1080p,

4k

Exemple:

"720p"

duration

integer

défaut:3

Durée vidéo en secondes ; par défaut 3. Accepte les entiers de 3 à 15. La durée influe directement sur la facturation.

Plage requise: 3 <= x <= 15

Exemple:

3

aspect_ratio

enum<string>

défaut:auto

Format : 16:9, 9:16 ou auto ; défaut auto.

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-reference-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 Référence vers vidéo

Autorisations

Corps

Réponse