APIMaster.ai

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.