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.1-flash-reference-to-video",
  "prompt": "Conserver l’apparence et le mouvement de caméra des références.",
  "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.1-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.1-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.1 Flash

Gemini Omni 1.1 Flash Référence vers vidéo

Génère une vidéo avec des images et vidéos de référence
image_urls: URLs d’images de référence. Obligatoire, maximum public 10. HTTP/HTTPS uniquement.
video_urls: Vidéos de référence facultatives, maximum 3 MP4 HTTP/HTTPS, chacune limitée à 10 secondes.
quality: Résolution : 360p, 720p, 1080p ou 4k. Défaut : 720p.
duration: Durée en secondes : entier de 3 à 10, défaut 3.
aspect_ratio: Format : 16:9, 9:16 ou auto ; défaut auto.
Le modèle génère automatiquement un audio natif synchronisé.
Écrivez les contraintes négatives directement dans prompt.
Traitement asynchrone: consulter l’état de la tâche
Les liens générés restent valides 24 heures.

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.1-flash-reference-to-video",
  "prompt": "Conserver l’apparence et le mouvement de caméra des références.",
  "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.1-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.1-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.1-flash-reference-to-video

requis

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

Options disponibles:

gemini-omni-1.1-flash-reference-to-video

Exemple:

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

prompt

string

requis

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

Exemple:

"Conserver l’apparence et le mouvement de caméra des références."

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 ; 3 vidéos maximum.

Les vidéos peuvent fournir des références de mouvement, de caméra ou de style et être utilisées avec image_urls.

Exigences d'entrée :

URL vidéo HTTP/HTTPS uniquement
Format : mp4
Chaque vidéo doit durer au maximum 10 secondes

Facturation : Chaque vidéo de référence ajoute des tokens d'entrée.

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 de la vidéo en secondes ; valeur par défaut 3.

Remarques :

Accepte tout entier de 3 à 10
La durée influe directement sur la facturation

Plage requise: 3 <= x <= 10

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"

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.1-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. L’endpoint de création retourne 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.1 Flash Référence vers vidéo

Autorisations

Corps

Réponse