Passer au contenu principal
POST
Ce point de terminaison est asynchrone. Après l’envoi, utilisez le task_id renvoyé avec GET /v1/videos/generations/{task_id} pour consulter l’état et le résultat de la tâche.

Fonctionnalités du modèle

PixVerse V6 Max est la version de PixVerse V6 offrant une meilleure qualité d’image. Il prend uniquement en charge la génération texte-vidéo et à partir d’une seule image, avec le même nom de modèle pixverse-v6-max. Pour les transitions entre images initiale et finale, la fusion de plusieurs images et le prolongement vidéo, utilisez PixVerse V6.

En-têtes de requête

string
requis
Authentification Bearer : Bearer <token>, où <token> est votre clé API APIMart.

Paramètres de requête

string
requis
Doit être pixverse-v6-max.
string
Décrit le contenu à générer. Obligatoire en texte-vidéo, jusqu’à 5000 caractères ; facultatif en image-vidéo, jusqu’à 2048 caractères.
string[]
Liste d’URL d’images d’entrée. Le mode image-vidéo accepte exactement 1 image ; en fournir 2 ou plus renvoie HTTP 400 de façon synchrone. Omettez ce champ pour le mode texte-vidéo.Les images doivent être accessibles publiquement via HTTP(S), au format JPEG, PNG ou WebP, de moins de 20 MB, avec chaque côté limité à 10000 pixels.
integer
défaut:"5"
Durée de sortie en secondes, de 1 à 15 ; valeur par défaut : 5.
string
défaut:"540p"
Résolution de sortie : 360p, 540p, 720p ou 1080p ; valeur par défaut : 540p.La sortie utilise les dimensions natives du modèle en amont ; les dimensions effectivement renvoyées font foi. Exemples observés lors des tests : 640×360 et 1108×832 (largeur × hauteur, en pixels).Le champ quality est aussi accepté. Si les deux sont fournis, resolution est prioritaire.
string
Champ de compatibilité pour la résolution, avec les mêmes valeurs que resolution. Utilisé uniquement en l’absence de resolution ; si les deux champs sont omis, 540p est utilisé.
string
défaut:"16:9"
S’applique uniquement au mode texte-vidéo. Accepte 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 et 21:9 ; valeur par défaut : 16:9.Le mode image-vidéo suit toujours le rapport d’aspect de l’image d’entrée ; ce champ est sans effet.
boolean
défaut:"false"
Définissez true pour générer une piste audio native ; la sortie est muette par défaut. La génération avec audio coûte plus cher par seconde.Seul le champ audio au premier niveau du corps de requête est pris en compte. metadata.generate_audio_switch n’active ni la piste audio ni la tarification avec audio.
integer
Graine aléatoire, de 0 à 2147483647.

Exemple image-vidéo

Remplacez l’URL d’exemple par celle d’une image réelle et accessible publiquement. Fournissez uniquement 1 image ; le rapport d’aspect de sortie suit cette image.

Consulter une tâche

Remplacez l’identifiant de tâche dans la requête suivante par le task_id renvoyé à l’envoi :

Facturation

Le coût correspond à la durée de sortie en secondes multipliée par le tarif par seconde de la résolution et de l’option audio choisies. Les sorties avec et sans audio ont des tarifs distincts ; l’audio coûte plus cher par seconde. Sans resolution ni quality, la sortie et la facturation utilisent toutes deux 540p. Les tarifs actuels sont fournis par le point de terminaison des prix du modèle :

Fonctionnalités non prises en charge et erreurs de paramètres

Les requêtes suivantes renvoient HTTP 400 de façon synchrone, sans créer de tâche ni facturer :