PixVerse V6.0 / C1 · Référence de l’API
Générez des vidéos PixVerse à partir de texte, d'images, d'images de début et de fin ou de références.
Utilisez pixverse-video-v6.0 ou pixverse-video-c1 comme identifiant de modèle. Soumettre JSON avec une clé API APIMaster dans l'en-tête Authorization: Bearer.
| Opération | Point de terminaison |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Début/fin des cadres | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| État des tâches | GET /v1/wand/pixverse/tasks/{task_id} |
| Champ | Type | Description |
|---|---|---|
model |
string | Obligatoire. Utilisez l'un des identifiants de modèle ci-dessus. |
prompt |
string | Obligatoire, jusqu'à 5,000 caractères. Les invites de référence peuvent utiliser @ref_name. |
duration |
integer | 1–15 secondes, y compris à 1080p. La valeur par défaut est 5 secondes. |
quality |
string | Obligatoire. 360p, 540p, 720p ou 1080p. |
aspect_ratio |
string | Text-to-video et reference-to-video uniquement. 16:9 (par défaut), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 ou 21:9. D'autres routes suivent l'image d'entrée. |
seed |
integer | De 0 à 2,147,483,647. Omettez le champ ou utilisez 0 pour une graine aléatoire. |
generate_audio_switch |
boolean | Définir true pour l'audio. Valeur par défaut : false. |
camera_movement |
string | Mouvement en option tel que zoom_in, pour text-to-video et image-to-video. |
generate_multi_clip_switch |
boolean | Optionnel pour V6.0 text-to-video et image-to-video. Valeur par défaut : false. |
img_id |
string | Requis pour image-to-video. Image publique URL ou Base64. |
img_ids |
string[] | Réservé à un modèle multi-images image-to-video. Une requête standard image-to-video utilise img_id. |
first_frame_img, last_frame_img |
string | Requis pour les requêtes start/end-frame. Utilisez URLs ou Base64. Utilisez des ratios d'aspect correspondants. |
image_references |
object[] | Requis pour reference-to-video. Jusqu'à sept articles avec img_id, en option type (subject ou background), et ref_name jusqu'à 30 caractères. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Nécessite ErrCode=0 ainsi qu'un statut HTTP réussi. La réponse contient ErrMsg, Resp.video_id et request_id. Sondage toutes les 3–5 secondes avec le même compte. Resp.status est 1 pour le succès, 5 pour le traitement, 6 pour la suppression, 7 pour l'échec de la révision du contenu et 8 pour l'échec de la génération. Resp.url est le dernier téléchargement temporaire URL et dure jusqu'à 12 heures. La réponse peut également inclure les dimensions, la taille, la graine, le style et les horodatages.
Consulter le statut conserve la tâche et les frais d’origine. Utilisez un Idempotency-Key de caractères 8–128 visibles ASCII pour récupérer une soumission. La même clé et les mêmes paramètres renvoient un reçu de récupération avec le statut HTTP 202. La même clé avec des paramètres différents renvoie le statut HTTP 409. Voir Guide de récupération des requêtes. L'API n'accepte pas de paramètre d'invite négative ou callback_url.
tokenhub_usage.total_tokens signale une utilisation facturable. La résolution et les paramètres audio affectent le prix. Voir les cartes de modèle PixVerse V6.0 et PixVerse C1 pour les prix actuels APIMaster.
