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-image-to-video",
  "prompt": "La personne tourne lentement la tête et sourit, tandis que les feuilles en arrière-plan bougent doucement au vent.",
  "image_urls": [
    "https://example.com/portrait.jpg"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

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

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-image-to-video) génère une vidéo avec audio natif à partir d’images et d’un prompt textuel.
Images initiale et finale : image_urls accepte 1 à 2 images. Une image définit la première image de la vidéo ; avec deux images, la première définit le début et la seconde la fin. Le modèle génère la transition. L’image finale ne peut pas être fournie seule.
Résolution : quality : 360p, 720p, 1080p ou 4k ; par défaut 720p.
Durée : duration en secondes entières, par défaut 3. Une image initiale : 3–15 secondes ; images initiale et finale : 3–10 secondes.
Format d’image : 16:9, 9:16 ou auto ; par défaut auto.
L’audio natif synchronisé est généré automatiquement, sans paramètre supplémentaire.
Inscrivez les contraintes négatives directement dans prompt, par exemple No dialogue ; aucun paramètre de prompt négatif séparé n’est proposé.
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-image-to-video",
  "prompt": "La personne tourne lentement la tête et sourit, tandis que les feuilles en arrière-plan bougent doucement au vent.",
  "image_urls": [
    "https://example.com/portrait.jpg"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

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

requis

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

Options disponibles:

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

Exemple:

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

prompt

string

requis

Prompt décrivant le mouvement entre la première et la dernière image.

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:

"La personne tourne lentement la tête et sourit, tandis que les feuilles en arrière-plan bougent doucement au vent."

image_urls

string<uri>[]

requis

Tableau de 1 à 2 images initiale et finale.

Une image : image initiale.
Deux images : image initiale, puis image finale. Le modèle génère la transition ; duration est limitée à 10 secondes.
L’image finale doit accompagner l’image initiale et ne peut pas être fournie seule.

Uniquement des URL d’images HTTP/HTTPS. Formats : png, jpeg, webp.

Required array length: 1 - 2 elements

Exemple:

[
  "https://example.com/first-frame.jpg",
  "https://example.com/last-frame.jpg"
]

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 en secondes, par défaut 3. Avec une image initiale : entier de 3 à 15. Avec les images initiale et finale : entier de 3 à 10. 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-image-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 Image vers vidéo

Autorisations

Corps

Réponse