Deux développeurs ont lu la documentation PixVerse ce matin. L’un a livré une fonctionnalité de prompt négatif. L’autre a appris que ce paramètre n’existe plus.
Tous deux lisaient des pages officielles. Tel est l’état réel de l’API PixVerse en 2026 : un service de génération vidéo performant et en évolution rapide, enveloppé dans une documentation où les pages anciennes et nouvelles se contredisent en silence. La plupart des questions des développeurs sur l’API PixVerse AI tournent autour de deux choses. Où sont les documents réellement à jour ? Et combien coûtera un clip une fois le code opérationnel ?
Ce guide répond aux deux. Chaque endpoint, paramètre et prix ci-dessous a été vérifié sur les pages officielles cette semaine, le 23 juillet 2026.
Points clés
- La documentation officielle de l’API PixVerse se trouve sur docs.platform.pixverse.ai. Les clés et les crédits se gèrent sur platform.pixverse.ai. L’application grand public sur app.pixverse.ai est un produit distinct avec sa propre facturation.
- Chaque appel nécessite deux en-têtes : API-KEY et un nouvel Ai-trace-id UUID par requête. La génération est asynchrone : soumettre, obtenir un video_id, interroger pour obtenir le résultat.
- La documentation se contredit par endroits. Les anciennes pages « comment faire » montrent encore negative_prompt et water_mark ; la référence de génération actuelle n’en comporte aucun. En cas de désaccord, faites confiance à la référence de l’endpoint.
- La facturation officielle se fait en crédits (10 $ pour 1 000). Le même modèle V6 est facturé à la seconde sur Atlas Cloud à partir de 0,025 $ par seconde, où le clip 720p par défaut de 5 secondes avec audio coûte 0,30 $ contre 0,60 $ en crédits par pack.
La carte de la documentation de l’API PixVerse : où se trouvent les vrais documents
Chercher la documentation de l’API PixVerse renvoie quatre surfaces officielles et une foule de revendeurs. Les quatre qui comptent :
| Surface | URL | Ce qu’elle couvre |
|---|---|---|
| Documentation Plateforme | docs.platform.pixverse.ai | Guide de démarrage, référence complète de l’API, tarifs des crédits, référence des erreurs, FAQ |
| Console développeur | platform.pixverse.ai | Créer des clés API, acheter des packs de crédits, suivre l’utilisation |
| Application grand public | app.pixverse.ai | L’application web. Ses forfaits, crédits gratuits et règles de filigrane ne s’appliquent pas à l’API |
| Serveur MCP officiel | github.com/PixVerseAI/PixVerse-MCP | Wrapper officiel permettant aux assistants IA d’appeler PixVerse directement |
La distinction qui pose problème est application vs plateforme. L’application vend des forfaits mensuels à partir de 10 $ et distribue des crédits gratuits quotidiens variables. La plateforme vend des crédits API et des abonnements sur un registre séparé. Un abonnement payant à l’application ne vous donne rien du côté API, et vice versa.
Un détail vraiment utile se cache dans la documentation de la plateforme : une page de texte brut consolidée nommée PixVerse-api-llm.txt qui regroupe toute la référence de l’API en un seul document. Collez-la dans votre assistant de codage et il pourra écrire des appels PixVerse selon les spécifications actuelles, au lieu de se fier aux données de son entraînement.
La documentation décrit un service derrière « plus de 100 millions de créateurs et entreprises dans 175 pays ». L’échelle est réelle. Le changement de version qui l’accompagne est la raison pour laquelle cet article comporte une section sur les contradictions.
Deux façons d’utiliser l’API PixVerse AI aujourd’hui
L’intégration avec la propre plateforme de PixVerse sera détaillée dans la section suivante. Le moyen le plus rapide de toucher d’abord les modèles est de passer par un hébergeur : Atlas Cloud propose PixVerse V6 et C1 parmi ses 400+ modèles, facturés à la seconde en dollars, sans packs de crédits ni filigrane. La page famille PixVerse liste les neuf endpoints hébergés, du texte vers vidéo à la référence vers vidéo et l’extension. Deux façons de procéder : tester dans le playground, puis appeler le même endpoint depuis le code. Le point de départ naturel est le playground V6 texte-vers-vidéo.
Méthode 1 : Tester l’API PixVerse V6 dans le playground
Avant d’écrire du code, passez dix minutes ici. Le playground est le même endpoint que votre code appellera, avec un devis de prix associé.
- Connectez-vous et ouvrez le playground. Le champ du prompt est la seule entrée obligatoire.
- Définissez la durée, la qualité et le rapport hauteur/largeur. Les valeurs par défaut sont 5 secondes, 720p, 16:9.
- Vérifiez l’interrupteur audio. Le son est activé par défaut et augmente le tarif à la seconde.
- Lisez le bouton Run. Il affiche le coût exact de vos réglages actuels. Avec les valeurs par défaut, cela donne 0,30 $, donc 10 $ couvrent environ 33 exécutions.
- Exécutez, examinez, téléchargez. Itérez sur le prompt jusqu’à ce que la sortie soit satisfaisante, puis reportez cette configuration exacte dans le code.
Méthode 2 : Appeler l’API PixVerse V6 depuis le code
Le workflow développeur PixVerse V6 sur Atlas Cloud consiste en deux requêtes HTTP.
Étape 1 : Obtenez votre clé API. Créez une clé dans la console Atlas Cloud et stockez-la comme variable d’environnement, jamais dans le code client.
Image : Capture d’écran de la page des clés API de la console Atlas Cloud, montrant le bouton de création de clé et une clé fraîchement générée à côté de son contrôle de copie.
Étape 2 : Consultez la documentation API. Les endpoints, paramètres et l’authentification se trouvent dans la documentation API.
Étape 3 : Effectuez votre première requête. Soumettez le travail :
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "Un lent travelling avant dans un marché nocturne mouillé par la pluie, des enseignes au néon se reflétant dans les flaques, de la vapeur s’élevant des stands de nourriture", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
La réponse renvoie un ID de prédiction. Interrogez-le jusqu’à ce que le statut indique « completed » :
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
La réponse complète contient l’URL de la vidéo hébergée. L’avantage durable est la forme de la requête : Atlas Cloud utilise une API unique pour tous les modèles, donc une clé, un en-tête d’authentification et une boucle soumission-interrogation couvrent PixVerse aujourd’hui et tout ce que vous ajouterez ensuite. Changer de modèle signifie simplement changer la chaîne du modèle, rien d’autre.
Dans les coulisses de la documentation officielle de l’API PixVerse AI : comment se déroule un appel réel
Si vous intégrez plutôt la propre plateforme de PixVerse, la présentation de l’API définit un flux en trois étapes sur le domaine de base app-api.pixverse.ai :
| Étape | Endpoint | Notes |
|---|---|---|
| Upload (image-vers-vidéo uniquement) | POST /openapi/v2/image/upload | Formulaire multipart. PNG, WebP ou JPEG de moins de 20 Mo. Renvoie un entier img_id |
| Génération | POST /openapi/v2/video/text/generate | Corps JSON. Renvoie un video_id |
| Interrogation | GET /openapi/v2/video/result/{video_id} | Le statut 1 signifie terminé, avec une URL de téléchargement dans la réponse |
L’authentification nécessite deux en-têtes sur chaque appel. API-KEY contient la clé de votre console plateforme. Ai-trace-id doit être un nouvel UUID par requête ; la documentation prévient que la réutilisation d’un même UUID bloque le démarrage de nouvelles générations.
La référence actuelle texte-vers-vidéo marque cinq champs obligatoires : prompt (jusqu’à 5 000 caractères), model, duration, quality et aspect_ratio. L’énumération des modèles accepte huit valeurs, de v3.5 à v5.6 plus v6 et c1, et les limites de durée suivent la génération : 5 ou 8 secondes jusqu’à v5, une option de 10 secondes sur v5.5 et v5.6, et n’importe quelle durée de 1 à 15 secondes sur v6 et c1. L’audio est optionnel via generate_audio_switch, qui est par défaut à false. Cette valeur par défaut est importante pour la budgétisation : le playground Atlas Cloud ci-dessus active le son par défaut, donc les deux voies citent des prix différents pour ce qui semble être le même clip.
L’image-vers-vidéo ajoute d’abord l’étape d’upload. Il n’est pas possible de passer une URL d’image publique ; vous uploadez le fichier, récupérez l’img_id renvoyé et le référencez dans le corps de la génération.
Deux faits opérationnels complètent le tableau, issus de la référence des erreurs. Les générations simultanées sont limitées par le niveau d’abonnement, et un slot bloqué se libère après environ 10 minutes. De plus, les statuts d’interrogation méritent d’être traités explicitement : 7 signifie que le prompt a déclenché la modération du contenu, 8 signifie une erreur côté serveur qui mérite une nouvelle tentative.
Là où la documentation de l’API PixVerse se contredit
La documentation de l’API PixVerse est un mélange de références d’endpoints actuelles et d’anciennes pages « comment faire » qui n’ont jamais été entièrement mises à jour. Lire la mauvaise page coûte un temps de débogage considérable. Les contradictions que nous avons vérifiées directement :
| Sujet | Une ancienne page de documentation dit | La référence actuelle dit |
|---|---|---|
| negative_prompt | Présenté dans les exemples de corps de requête de la présentation de l’API | N’est pas un champ sur l’endpoint de génération |
| water_mark | « water_mark » : false apparaît dans les mêmes exemples | Absent de la liste actuelle des paramètres |
| Durée du clip | Le README MCP code en dur « 5s ou 8s » | N’importe quelle durée de 1 à 15 secondes sur v6 et c1 |
| Limite d’upload d’image | Page de dépannage : 4000×4000 pixels | Référence d’upload : 10 000 pixels |
| Longueur du prompt | Guide pratique : gardez les prompts entre 25 et 200 mots | Limite stricte de 5 000 caractères, sans indication de mots |
Deux règles couvrent les cinq lignes. Lorsque les pages sont en désaccord, faites confiance à la référence de l’endpoint plutôt qu’à la page « comment faire » ; les références contiennent les spécifications actuelles, les guides contiennent l’historique. Et lorsque les limites diffèrent, codez pour la plus restrictive, donc 4000 pixels pour les uploads.
L’énumération des versions mérite son propre avertissement. Les anciens noms de modèles fonctionnent toujours : v3.5, v4 et v4.5 restent des valeurs valides, donc les intégrations datant de 2025 n’ont pas été cassées. Elles paient juste plus cher. En 720p pour 5 secondes sans audio, la tarification officielle facture 60 crédits sur V4 mais 45 sur V6. Si vous héritez d’une base de code avec une ancienne chaîne de modèle, la mettre à niveau est un changement d’une ligne qui réduit les coûts et améliore la sortie. Seule la génération V2 a complètement disparu de l’accès direct.
Tarification de l’API PixVerse : crédits sur la plateforme, dollars sur Atlas Cloud
La plateforme officielle PixVerse facture en crédits, et sa page de tarification étiquette les tableaux de modèles « Calculé par seconde ». Les packs de crédits vont de 10 $ pour 1 000 crédits à 5 000 $ pour 500 000, avec des abonnements mensuels allant du plan Essentiel à 100 $ (15 000 crédits) jusqu’au niveau Business à 6 000 $. La consommation de crédits par seconde pour les modèles actuels :
| Qualité | V6 (sans audio / avec audio) | C1 (sans audio / avec audio) |
|---|---|---|
| 360p | 5 / 7 crédits | 6 / 8 crédits |
| 540p | 7 / 9 crédits | 8 / 10 crédits |
| 720p | 9 / 12 crédits | 10 / 13 crédits |
| 1080p | 18 / 23 crédits | 19 / 24 crédits |
Atlas Cloud facture les deux mêmes modèles en dollars par seconde, sans pack ni abonnement préalable. Vérifié sur les pages de modèles en direct le 23 juillet 2026, au prix catalogue sans remise en cours :
| Qualité | V6 (sans audio / avec audio) | C1 (sans audio / avec audio) |
|---|---|---|
| 360p | 0,025 $ / 0,035 $ | 0,030 $ / 0,040 $ |
| 540p | 0,035 $ / 0,045 $ | 0,040 $ / 0,050 $ |
| 720p | 0,045 $ / 0,060 $ | 0,050 $ / 0,065 $ |
| 1080p | 0,090 $ / 0,115 $ | 0,095 $ / 0,120 $ |
Un clip rend la comparaison concrète. Un clip V6 de 5 secondes en 720p avec audio coûte 60 crédits : soit 0,60 $ au tarif du pack à 10 $, ou environ 0,40 $ au tarif de l’abonnement Essentiel après avoir engagé 100 $ pour le mois. Mesuré sur Atlas Cloud, le clip identique coûte 0,30 $. Le modèle C1 est légèrement plus cher par seconde, à 0,325 $ pour ce même clip via le playground C1, ce qui achète son réglage pour la production cinématographique.
Les crédits ont toujours du sens pour les équipes déjà présentes sur la plateforme PixVerse, en particulier au volume Scale où le taux effectif diminue. Pour tous les autres, la tarification en dollars par seconde est plus facile à prévoir : le prix d’un rendu est la durée multipliée par le taux, lisible avant de dépenser.
L’entreprise développeur de PixVerse AI derrière l’API
Une API est un pari sur l’entreprise qui la gère, et l’entreprise développeur de PixVerse AI mérite d’être connue avant de construire. PixVerse est développé par AISphere (Aishi Technology), fondée en avril 2023 à Pékin et désormais basée à Singapour avec environ 150 employés. Le fondateur et PDG Wang Changhu a dirigé les travaux de vision de l’AI Lab de ByteDance de 2017 à 2021, ce qui fait de PixVerse un rival direct de Seedance, développé par son ancien employeur. Le cofondateur Jaden Xie vient de Lighthouse Capital.
Le tableau du financement est exceptionnellement solide pour un atelier de modèles vidéo indépendant. Le 13 juillet 2026, la société a clôturé une extension de Série C portant le tour à 439 millions de dollars à une valorisation supérieure à 2 milliards de dollars, avec la participation d’Alibaba, selon TechCrunch. Pour un développeur, cela se lit comme une piste : l’API que vous intégrez ce trimestre a peu de chances de disparaître l’année prochaine.
L’envers d’un laboratoire bien financé est la rapidité de livraison. La seule ligne de lancements de 2026 :
Trois lancements de modèles en trois mois expliquent le retard de documentation que cet article ne cesse de signaler. Construisez en conséquence : figez votre chaîne de modèle, lisez les notes de version avant de la modifier, et revérifiez la référence de l’endpoint plutôt que de supposer que les paramètres du trimestre dernier ont survécu.
Foire aux questions
Où se trouve la documentation officielle de l’API PixVerse ?
Sur docs.platform.pixverse.ai, avec la console développeur sur platform.pixverse.ai. Tout ce qui est hébergé sur app.pixverse.ai est le produit grand public, et les pages tierces de « documentation de l’API PixVerse » décrivent fréquemment les paramètres de l’ère v4. La documentation inclut également une page de texte consolidée prête pour les LLM que vous pouvez fournir à un assistant de codage.
Comment obtenir une clé API PixVerse ?
Inscrivez-vous sur la console de la plateforme à platform.pixverse.ai, créez une clé et transmettez-la dans l’en-tête API-KEY avec un identifiant Ai-trace-id UUID unique par requête. Les clés sont liées aux crédits de la plateforme, achetés séparément de tout abonnement à l’application grand public. Sur Atlas Cloud, l’équivalent est une clé de console transmise comme un jeton Bearer standard.
L’API PixVerse a-t-elle un niveau gratuit ?
La documentation de tarification de la plateforme ne mentionne que des packs de crédits et des abonnements payants. Les crédits gratuits quotidiens variables que PixVerse annonce appartiennent à l’application grand public et ne sont pas transférés au registre de l’API. Les points d’entrée payants les moins chers sont un pack de crédits à 10 $ sur la plateforme officielle ou une génération mesurée à partir de 0,025 $ par seconde sur Atlas Cloud.
Quels modèles l’API PixVerse peut-elle exécuter ?
L’endpoint de génération actuel accepte huit valeurs de modèle : v3.5, v4, v4.5, v5, v5.5, v5.6, v6 et c1. V6 et C1 sont la génération actuelle, avec des clips de 1 à 15 secondes et un audio natif optionnel. Les anciens noms fonctionnent toujours mais coûtent plus de crédits pour les mêmes réglages que V6. La génération V2 n’est plus disponible en direct.
Combien coûte l’API PixVerse AI par vidéo ?
Plateforme officielle : un clip V6 de 5 secondes en 720p avec audio coûte 60 crédits, soit environ 0,60 $ au tarif du pack à 10 $. Atlas Cloud : le même clip coûte 0,30 $ mesuré, à partir d’une fourchette par seconde de 0,025 $ à 0,115 $ selon la résolution et l’audio. C1 est légèrement plus élevé, à 0,325 $ pour ce clip. Prix vérifiés le 23 juillet 2026.
Conclusion
L’API PixVerse est en meilleur état que sa documentation. Le service lui-même est rapide, bien financé et à jour : huit valeurs de modèle, des clips jusqu’à 15 secondes, de l’audio en une seule passe, et un flux asynchrone que n’importe quel développeur junior peut câbler en un après-midi. La documentation n’a tout simplement pas suivi le rythme du calendrier des versions, de sorte que les références des endpoints et les guides pratiques décrivent des produits différents.
La méthode de travail est simple. Faites confiance à la référence de l’endpoint, codez pour la limite la plus stricte en cas de désaccord entre les pages, et figez votre chaîne de modèle. Ensuite, choisissez votre forme de facturation : des crédits sur la plateforme officielle si votre équipe y vit déjà, ou des dollars à la seconde à partir de 0,025 $ si vous voulez que le prix de chaque rendu soit lisible avant de l’envoyer. Le clip par défaut à 0,30 $ dans le playground est un endroit bon marché pour découvrir de quel côté vous êtes.
