Skip to main content
POST

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 :

Corps

application/json
model
enum<string>
requis

Choisissez l’ID de modèle correspondant à la tâche et aux médias d’entrée :

  • gemini-omni-1.1-flash-text-to-video
  • gemini-omni-1.1-flash-image-to-video
  • gemini-omni-1.1-flash-reference-to-video
  • gemini-omni-1.1-flash-video-edit
  • gemini-omni-1.1-flash-video-extend
Options disponibles:
gemini-omni-1.1-flash-text-to-video,
gemini-omni-1.1-flash-image-to-video,
gemini-omni-1.1-flash-reference-to-video,
gemini-omni-1.1-flash-video-edit,
gemini-omni-1.1-flash-video-extend
Exemple:

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

prompt
string
requis

Prompt de génération, de montage ou d’extension.

Exemple:

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

image_urls
string<uri>[]

URLs d’images : 1–2 images initiale/finale ; jusqu’à 10 références ; jusqu’à 10 images facultatives pour le montage et l’extension.

Required array length: 1 - 10 elements
Exemple:
video_urls
string<uri>[]

Vidéos : jusqu’à 3 références de 10 s ; une vidéo de 10 s pour le montage ; une vidéo de 30 s pour l’extension.

Required array length: 1 - 3 elements
Exemple:
quality
enum<string>

Résolution vidéo

Valeurs prises en charge :

  • 360p : paysage 640×360 / portrait 360×640
  • 720p : paysage 1280×720 / portrait 720×1280
  • 1080p : paysage 1920×1080 / portrait 1080×1920
  • 4k : paysage 3840×2160 / portrait 2160×3840
  • auto : montage et extension uniquement ; suit la résolution de la vidéo d'entrée

Valeurs par défaut :

  • Texte/Image/Référence : 720p
  • Montage/Extension : auto

Facturation : La sortie est facturée en tokens de sortie. Pour le montage et l'extension, les tokens de la vidéo d'entrée et de sortie sont calculés selon la résolution de sortie finale.

Options disponibles:
360p,
720p,
1080p,
4k,
auto
Exemple:

"720p"

duration

Durée de la vidéo

  • Texte/Image/Référence vers vidéo : entier de 3 à 10 secondes ; valeur par défaut 3
  • Montage vidéo : seule la valeur auto est acceptée ; valeur par défaut auto ; la durée suit la vidéo d'entrée
  • Extension vidéo : entier de 3 à 10 secondes ; valeur par défaut 3 ; indique les secondes ajoutées
Plage requise: 3 <= x <= 10
Exemple:

3

aspect_ratio
enum<string>
défaut:auto

Format par défaut auto ; montage et extension acceptent uniquement 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

id
string

ID de la tache

Exemple:

"task-unified-1757169743-7cvnl5zw"

model
string

Nom du modele reellement utilise

Exemple:

"gemini-omni-1.1-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. L’endpoint de création retourne processing.

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"processing"

task_info
object

Informations detaillees sur la tache video

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