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>
défaut:gemini-omni-1.1-flash-video-edit
requis

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

Options disponibles:
gemini-omni-1.1-flash-video-edit
Exemple:

"gemini-omni-1.1-flash-video-edit"

prompt
string
requis

Instruction décrivant le montage souhaité et les éléments à conserver.

Exemple:

"Rendre la lumière plus chaude sans modifier le reste."

video_urls
string<uri>[]
requis

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

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

Tableau facultatif d'images de référence, jusqu'à 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

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

Required array length: 1 - 10 elements
Exemple:
quality
enum<string>
défaut:auto

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

Valeurs prises en charge :

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

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

Facturation : Les tokens des vidéos d'entrée et de sortie sont calculés selon la résolution de sortie finale ; une résolution plus élevée coûte davantage.

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

"auto"

duration
enum<string>
défaut:auto

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

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

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-video-edit"

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