Skip to main content
POST

Authentification

string
requis
Tous les endpoints nécessitent une authentification par Bearer Token.Obtenir une clé API :Visitez la page de gestion des clés API pour obtenir votre clé API.Ajoutez l’en-tête suivant à votre requête :

Paramètres de requête

string
requis
Nom du modèle de génération vidéo. Fixé à pixverse-v6.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description du contenu de la vidéo, jusqu’à 5000 caractères. Obligatoire dans tous les modes.
string
défaut:"540p"
Niveau de résolution vidéo. Influence directement la facturation.
  • 360p : SD
  • 540p : Standard (par défaut)
  • 720p : HD
  • 1080p : Full HD
Toute autre valeur de résolution renverra une erreur de paramètre.
integer
défaut:"5"
Durée de la vidéo en secondes, plage 1–15.
Le mode transition premier/dernier frame ne prend en charge que 5 ou 8 secondes.
string
défaut:"16:9"
Rapport hauteur/largeur de la vidéo. Effectif uniquement en mode texte vers vidéo et fusion multi-références.
  • 16:9 : Paysage écran large (par défaut)
  • 4:3 : Paysage 4:3
  • 1:1 : Carré
  • 3:4 : Portrait 3:4
  • 9:16 : Portrait vertical
  • 2:3 : Portrait 2:3
  • 3:2 : Paysage 3:2
  • 21:9 : Cinémascope
integer
défaut:"0"
Graine aléatoire, plage 0–2147483647. Le même prompt et la même seed reproduisent des résultats similaires.
string
Prompt négatif pour exclure les contenus indésirables. Jusqu’à 2048 caractères.
boolean
défaut:"false"
Indique si une piste audio est générée.
  • true : Générer une piste audio (augmente le tarif)
  • false : Sans audio (par défaut)
boolean
défaut:"false"
Indique si un filigrane est ajouté en bas à droite de la vidéo.
  • true : Ajouter un filigrane
  • false : Sans filigrane (par défaut)
string
Mode de mouvement.
  • normal : Mode standard (pixverse-v6 ne prend en charge que cette valeur)
fast est réservé aux anciens modèles et sera rejeté par l’amont pour pixverse-v6.
boolean
défaut:"false"
Indique s’il faut générer une vidéo multi-clips continue. Pris en charge uniquement en mode texte vers vidéo et image vers vidéo.
  • true : Générer une vidéo multi-clips continue
  • false : Clip unique (par défaut)
array<url>
Tableau d’URL d’images d’entrée pour image vers vidéo. Seule la première image est utilisée.Les images doivent être des URL HTTP/HTTPS publiques.
url
URL du premier frame en mode transition. Doit être fourni avec last_frame_image.
url
URL du dernier frame en mode transition. Doit être fourni avec first_frame_image.
array<url>
Tableau d’URL d’images de référence pour le mode fusion multi-références. Prend en charge 1–7 images.Fournir ce champ déclenche le mode fusion multi-références.
string
ID de la tâche source pour l’extension vidéo. Fournir ce champ déclenche le mode extension.La tâche source doit appartenir à l’utilisateur courant, utiliser le modèle pixverse-v6 et avoir le statut completed.

Modes de génération

L’adaptateur dispatch automatiquement vers le mode de génération correspondant selon les champs de la requête. La correspondance se fait par ordre de priorité, le premier qui correspond gagne.
Toutes les entrées d’image acceptent uniquement des URL HTTP/HTTPS publiques. base64 et Data URI ne sont pas pris en charge. Si vous n’avez que des images locales, téléversez-les d’abord vers un stockage objet et passez l’URL.

Règles des paramètres

Réponse

integer
Code de statut de la réponse. 200 en cas de succès.
array
Tableau de tâches retourné.

Récupération du résultat de la tâche

La génération vidéo est une tâche asynchrone. Après soumission, un task_id est retourné. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et le résultat.
cURL
Il est recommandé d’interroger toutes les 5 secondes jusqu’à ce que le statut devienne completed ou failed.

Exemple : succès

L’URL de la vidéo se trouve à data.result.videos[0].url[0]. Le champ url est lui-même un tableau. Les liens vidéo expirent généralement après 24 heures — téléchargez ou transférez-les rapidement.

Exemple : échec

En cas d’échec, cost vaut généralement 0. La cause de l’erreur se trouve dans data.error.message.

Cas d’utilisation

Cas 1 : Texte vers vidéo

Cas 2 : Image vers vidéo

Cas 3 : Transition premier/dernier frame

Cas 4 : Fusion multi-références

Cas 5 : Extension vidéo