API v0 : comment créer et déployer des applications

Ce que permet réellement l’API v0

À partir d’une demande en langage naturel, l’API v0 produit une application full-stack fonctionnelle, pas une simple suggestion de code. Elle génère le code, l’exécute dans une Vercel Sandbox, fournit une prévisualisation en direct sécurisée et mène directement au déploiement sur Vercel.

Chaque chat v0 peut être vu comme un atelier privé consacré à une application. L’identifiant du chat en est la clé. v0 peut y lire, modifier et exécuter les fichiers, tandis que chaque nouveau message repart de l’état existant. Si le premier demande un tableau de bord pour trier des tickets et le suivant une colonne d’attribution, cette seconde instruction modifie l’application déjà présente dans l’atelier.

C’est cette boucle avec état qui fait la différence. Un modèle de code classique fournit du texte et vous laisse gérer l’exécution. v0 lance le serveur de développement, vérifie le code en fonctionnement et peut détecter puis corriger les erreurs au fil de son travail.

La nouvelle API v2 s’articule autour de quatre éléments faciles à appréhender sans connaître son fonctionnement interne :

• Les chats regroupent les fichiers actuels de l’application, ses métadonnées, son niveau de confidentialité et le lien vers le projet Vercel.
• Les messages contiennent les instructions et l’historique. La liste ordonnée de leurs parts peut faire apparaître du texte, le raisonnement, la lecture et la modification de fichiers, des recherches, des commandes shell, des appels d’outils et des actions de l’agent.
• Les prévisualisations sont des builds en cours d’exécution, protégés par un jeton à courte durée de vie.
• Les déploiements envoient sur Vercel l’état actuel du chat.

C’est aussi pourquoi les anciens exemples peuvent prêter à confusion. Le guide de démarrage rapide actuel de la v2 importe le package v0. Les exemples v1 plus anciens utilisent v0-sdk, et les identifiants de chat v1 ne fonctionnent pas avec la v2.

Comment utiliser l’API v0

La voie la plus courte et la plus sûre consiste à placer une petite route serveur entre votre interface et v0. Le navigateur lui transmet le prompt de l’utilisateur. Le serveur conserve la clé API, appelle v0, enregistre l’identifiant du chat reçu en retour et ne renvoie que le résultat nécessaire à l’interface.

1. Choisir le bon point d’entrée

Trois approches sont possibles :

1. Démarrer avec une interface complète de génération d’applications grâce à npx create-v0-sdk-app.
2. Ajouter le SDK côté serveur à un produit existant avec npm install v0.
3. Donner accès à un agent existant via le serveur MCP distant de v0, qui s’appuie sur OAuth au lieu d’inscrire une clé API dans la configuration MCP.

Le starter est le moyen le plus rapide d’observer le workflow complet. Il comprend une interface de chat en React, des routes proxy côté serveur, des vues pour les fichiers générés, une application de prévisualisation isolée et un skill d’agent v0.

2. Créer la clé et la conserver côté serveur

Créez une clé API dans les paramètres de v0 et stockez-la sous V0_API_KEY dans l’environnement du serveur. Ne l’exposez jamais dans le code du navigateur et ne lui ajoutez pas le préfixe NEXT_PUBLIC_.

Votre wrapper local peut démarrer avec npm run dev, mais ses routes serveur continuent d’appeler l’API v0 hébergée. Il s’agit d’une intégration locale, pas d’une copie locale du système de création d’applications de v0.

3. Créer un chat par application

Le premier appel ouvre à la fois une conversation et un espace de travail pour l’application :

import { v0 } from 'v0'

const created = await v0.chats.create({
  message: 'Build an issue triage app for a support team.',
})

if (created.error) throw new Error(created.error.message)
const chatId = created.data.chat.id

const changed = await v0.messages.send({
  chatId,
  message: 'Add a priority filter and an assignee column.',
})

if (changed.error) throw new Error(changed.error.message)

Conservez chatId avec l’enregistrement correspondant dans votre propre système : client, espace de travail ou tâche. Les métadonnées peuvent également regrouper les chats à partir de ces mêmes identifiants, mais elles servent à l’organisation, pas au contrôle d’accès.

Il n’est pas nécessaire de partir d’un prompt vide. Un chat peut être initialisé depuis un dépôt GitHub, une archive ZIP ou un ensemble de fichiers.

4. Choisir le mode de retour du travail

Préférez un appel synchrone si l’appelant peut attendre le résultat final. Pour les scripts, webhooks et tâches de CI qui doivent mettre le travail en file d’attente puis en vérifier l’avancement, choisissez un appel asynchrone. Le streaming convient lorsqu’une personne suit l’opération et que l’interface doit montrer l’agent en train de lire des fichiers, de modifier du code, d’exécuter des commandes et de signaler sa progression.

Les réponses des chats et des messages incluent les données d’usage. Vous pouvez donc enregistrer le nombre de tokens et le coût en crédits à la fin de chaque tâche.

5. Faire transiter la prévisualisation par un proxy

L’API renvoie une URL de prévisualisation et un jeton à courte durée de vie. Une iframe dans le navigateur ne peut pas transmettre elle-même ce jeton en toute sécurité ; l’architecture documentée fait donc transiter ses requêtes par un proxy backend que vous contrôlez.

Installez ce proxy sur un site réservé aux prévisualisations, dont le domaine enregistrable diffère de celui de votre application principale. Le code exécuté dans les prévisualisations générées n’est pas fiable. Le proxy doit aussi authentifier l’utilisateur actif et vérifier qu’il est autorisé à accéder au chat demandé. Le helper de prévisualisation v0 n’effectue pas ce contrôle à votre place.

6. Ne déployer qu’après vos propres vérifications

Une fois l’application prête, v0.chats.deploy({ chatId }) déploie l’état actuel du chat sur Vercel. Les variables d’environnement appartiennent au projet Vercel associé et se gèrent via l’API Vercel. Les identifiants de base de données et les clés de services tiers exigent donc une étape de configuration distincte et volontaire.

Combien coûte l’API v0 ?

v0 facture l’usage sous forme de crédits plutôt qu’à un tarif fixe par application générée. Les tokens d’entrée couvrent le prompt, les contenus importés, l’historique du chat, les fichiers source et les autres éléments de contexte lus par v0. Les tokens de sortie correspondent à ce que produit l’agent. Le coût d’un chat peut donc augmenter à mesure que son historique et sa base de code s’allongent.

L’offre Free coûte $0 par mois, comprend $5 de crédits mensuels et impose une limite quotidienne de sept messages. Plus revient à $30 par utilisateur et par mois, et Business à $100 par utilisateur et par mois ; toutes deux incluent $30 de crédits mensuels par utilisateur. La génération s’interrompt lorsque les crédits disponibles sont épuisés.

Pour un produit destiné à des clients, consignez l’usage renvoyé par chaque appel de chat et de message. Attribuez à chaque organisation cliente un budget, une limite de tâches, ou les deux. Sans cela, un dépôt exceptionnellement volumineux ou une boucle de révisions sans fin peut engloutir le solde commun.

Sept cas d’usage, classés selon leurs principaux bénéficiaires

Les usages les plus convaincants intègrent v0 à un workflow existant, dans lequel le produit connaît déjà l’utilisateur, les données et le type d’application attendu.

Si vous hésitez entre utiliser v0 comme moteur sous-jacent et en faire votre produit complet, comparez-le aux meilleurs générateurs d’applications IA en 2026. La distinction est importante : une API est pertinente lorsque vous voulez maîtriser l’expérience client, les règles, la facturation et le processus de validation.

Trois produits qui méritent d’être créés

La demande est réelle, mais le marché des générateurs d’applications généralistes est déjà très concurrentiel. L’opportunité n’est pas de proposer une nouvelle zone de prompt vide, mais un builder qui maîtrise particulièrement bien une tâche à forte valeur.

1. Le meilleur pari : intégrer un générateur d’applications vertical à un SaaS existant

Créez un générateur spécialisé dans un seul métier, vendu comme extension d’un logiciel déjà utilisé par les clients concernés. Une plateforme de gestion immobilière pourrait produire des portails pour les propriétaires ; une plateforme logistique, des tableaux de bord sur les incidents d’expédition ; une plateforme de franchise, des outils de suivi pour l’ouverture de nouveaux sites.

La demande est assez large pour soutenir cette catégorie. ai app builder recueille environ 12,100 recherches Google par mois aux États-Unis et le jeu de données indique une croissance annuelle de 50%. Les internautes demandent à des assistants d’IA de build an app with ai environ 392 fois par mois, contre 231 en août 2025, soit une progression d’environ 70%. Les générateurs d’applications existants facturent déjà entre $16 et $160 par mois, signe que les acheteurs acceptent un abonnement logiciel récurrent pour répondre à ce besoin.

La plus petite version commercialisable doit proposer deux ou trois types d’applications approuvés, un formulaire de cadrage structuré, un chat v0 par application client, un écran de validation en streaming, un proxy de prévisualisation sécurisé et un bouton de déploiement contrôlé par une personne. Son avantage défendable tient au modèle de données, aux autorisations, aux modèles et à la distribution du produit hôte.

Le constat est brutal mais utile : un simple wrapper généraliste n’a pratiquement aucune défense. Si le produit ne peut pas nommer ce qu’il sait du métier du client et que v0 ne sait pas à lui seul, mieux vaut renoncer.

2. Un générateur en marque blanche de sites et de campagnes pour les agences

Proposez à une agence un formulaire client à ses couleurs, un ensemble fixe de types de pages, son propre skill de design system, une file de révisions et un passage de relais pour le déploiement. Le client reste dans l’univers de l’agence, tandis que v0 gère en coulisses l’espace de travail de l’application et sa prévisualisation en direct.

ai website builder totalise environ 40,500 recherches Google mensuelles aux États-Unis, avec une croissance annuelle de 49% dans le jeu de données. C’est le plus grand volume visible de cette étude, ce qui signifie aussi que le marché compte déjà de nombreux concurrents solides. Le bon angle n’est pas « créer n’importe quel site », mais « créer le type de site de cette agence, avec cette stack, ces composants et ce processus d’approbation ».

Le MVP requiert une configuration de marque, trois modèles de pages, l’import de ressources, des commentaires sur la prévisualisation et une validation du déploiement. Le vrai défi sera le support : si les textes, la mise en page, l’accessibilité ou les intégrations générés doivent être corrigés, les clients tiendront l’agence — pas v0 — pour responsable.

3. Un bot qui transforme une demande de fonctionnalité en prévisualisation

Transformez une issue approuvée en proposition fonctionnelle. Une GitHub App ou un webhook interne importe le dépôt, ouvre un chat v0 asynchrone, enregistre son identifiant et publie la prévisualisation dans le ticket. Une personne l’examine avant tout merge ou déploiement.

Google comptabilise environ 390 recherches mensuelles aux États-Unis pour how to build an app with ai, et le jeu de données fait état d’une croissance annuelle de 86%. En juillet 2026, la demande adressée aux assistants d’IA pour build an app with ai a atteint 392 prompts mensuels. Cela confirme l’intérêt pour des applications complètes et fonctionnelles, sans toutefois prouver l’existence d’un marché autonome autour de la CI. Il vaut mieux en faire une fonctionnalité d’équipe ou une extension de plateforme pour développeurs qu’un produit généraliste en libre-service.

Le MVP se compose d’un webhook, d’une liste de dépôts autorisés, d’un exécuteur de tâches asynchrones, d’un stockage des chats v0, d’une prévisualisation isolée et d’un statut d’approbation. Le principal écueil tient au risque : le code généré pour la prévisualisation n’est pas fiable, l’accès au dépôt est sensible et une démonstration crédible ne garantit ni la réussite des tests, ni la sécurité, ni les migrations, ni la gestion correcte des cas limites. Le déploiement en production ne doit jamais être l’action par défaut.

Pour replacer v0 parmi les agents de programmation et les outils qui transforment un prompt en application, consultez les meilleurs outils de vibe coding en 2026.

Ce que l’API v0 ne résout pas

L’API fournit un agent chargé de créer l’application ainsi que son atelier. Tout le produit qui l’entoure reste sous votre responsabilité.

• Elle ne décide pas de ce qu’il faut construire. Une demande vague peut toujours aboutir à une version soignée du mauvais produit. La qualité du cadrage, des modèles, des contraintes et des étapes de validation reste déterminante.
• Elle ne gère pas les autorisations de vos clients. Le helper de prévisualisation transmet le trafic, mais votre application doit décider qui peut accéder à chaque chat.
• Elle ne rend pas fiable le code généré. Servez les prévisualisations depuis un site dédié utilisant un autre domaine enregistrable, et relisez le code avant son passage en production.
• Elle ne transfère pas les chats v1 vers la v2. Choisissez une version v1, téléchargez-la sous forme d’archive ZIP, puis créez un nouveau chat v2 à partir de cet état.
• Elle ne remplace pas l’API Vercel. Les variables d’environnement et plusieurs opérations liées au projet restent rattachées au projet Vercel associé.
• Elle ne rend pas les coûts fixes. Les fichiers source, l’historique de la conversation, les prompts et la sortie contribuent tous à l’usage de tokens.
• Ce n’est pas un moteur local de création d’applications. Vous pouvez exécuter votre intégration en local, mais le workflow documenté appelle l’API v0 hébergée et lance les prévisualisations dans l’infrastructure Vercel.

Mon avis : v0 est pertinent lorsque la prévisualisation fonctionnelle et les itérations avec état constituent l’avantage du produit. Pour un simple extrait de code, un composant ponctuel ou une transformation de fichier strictement déterministe, l’espace de travail, le proxy, le suivi des crédits et le mécanisme de déploiement représentent une complexité superflue.

Si vous souhaitez concevoir et sécuriser pour la production un builder propulsé par v0, je développe des systèmes d’IA prêts pour la production.