Passer au contenu principal
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>
défaut:gemini-omni-1.2-flash-video-extend
requis

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

Options disponibles:
gemini-omni-1.2-flash-video-extend
Exemple:

"gemini-omni-1.2-flash-video-extend"

prompt
string
requis

Prompt décrivant la suite après la vidéo d’entrée.

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 continue d’avancer et sort lentement du cadre."

video_urls
string<uri>[]
requis

Exactement un MP4 HTTP/HTTPS, limité à 30 secondes.

Required array length: 1 element
Exemple:
image_urls
string<uri>[]

Tableau facultatif d'images de référence, jusqu'à 10 images, pour guider l'extension du sujet, du style ou des éléments.

Exigences d'entrée :

  • URL d'image HTTP/HTTPS uniquement
  • Formats pris en charge : png, jpeg, webp

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

Required array length: 1 - 10 elements
Exemple:
duration
integer
défaut:3

Durée vidéo ajoutée en secondes ; valeur par défaut 3.

Remarques :

  • Accepte tout entier de 3 à 10
  • Indique le nombre de secondes générées après la vidéo d'entrée, et non la durée totale
  • Durée totale de sortie = durée de la vidéo d'entrée + duration
  • La durée ajoutée influe directement sur la facturation
Plage requise: 3 <= x <= 10
Exemple:

3

quality
enum<string>
défaut:auto

Résolution de sortie ; par défaut auto.

  • 360p : côté court de 360.
  • 720p : côté court de 720.
  • 1080p : côté court de 1080.
  • 4k : côté court de 2160.
  • auto : suit la résolution d’entrée ; valeur par défaut.

Une valeur explicite peut augmenter ou réduire la résolution de sortie.

Facturation : Les tokens vidéo de sortie augmentent avec la résolution de sortie. La vidéo d’entrée compte aussi en tokens ; une résolution plus élevée coûte davantage.

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

"auto"

aspect_ratio
enum<string>
défaut:auto

Seule la valeur auto est autorisée et utilisée par défaut ; le format suit la vidéo d’entrée.

Options disponibles:
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

id
string

ID de la tache

Exemple:

"task-unified-1757169743-7cvnl5zw"

model
string

Nom du modele reellement utilise

Exemple:

"gemini-omni-1.2-flash-video-extend"

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

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