Vuncloud Blog
← Retour aux notes de dev

Agents API OpenAI en pratique : construire un agent, le déployer, calculer le coût API et serveur

Trois lignes de facture · une session · une feuille à modifierEnviron 12 minutes

Une personne tape du code sur un portable à côté d’une tasse, pour construire un agent OpenAI et vérifier le coût API et serveur

L’Agents API d’OpenAI est entrée en bêta publique le 10 septembre 2026. Vous choisissez le modèle, les outils et l’environnement. OpenAI héberge le harness qui fait tourner Codex. L’API elle-même n’ajoute aucun frais de plateforme. Une facture a en général trois lignes : tokens du modèle, outils intégrés, et durée de conteneur seulement si vous utilisez vraiment le sandbox hébergé. Si le travail exige xcodebuild, un simulateur ou une signature, un sandbox Linux ne suffit pas. Cette étape demande un Mac qui reste allumé.

Aujourd’hui, c’est le DevDay (29 septembre 2026, San Francisco). Les tarifs ci-dessous viennent de la page des prix, de la page du modèle GPT-6 Astra et de l’annonce de l’Agents API, telles qu’ouvertes au moment de la rédaction. Si le keynote change un prix, la console et la page des prix l’emportent. La carte des fonctions est dans l’aperçu du DevDay et dans fonctions et prix de GPT-6 Astra.

$0
Frais de plateforme de l’Agents API
$10 / $50
Astra, contexte court, par million de tokens
$101.7
M4 16 Go, mensuel à partir de, accueil

Découper la facture en trois lignes

« L’agent est cher » additionne souvent quatre choses : un modèle phare, la recherche, un conteneur au ralenti, et une machine louée seulement parce que le travail exige macOS. Une fois séparées, la boucle quotidienne est chère à cause du palier de modèle, pas parce que vous avez appelé l’Agents API.

LigneQuand elle apparaîtTarif visible à la rédaction
Tokens du modèle À chaque inférence Contexte court, par million de tokens, entrée / sortie : Luna 0,10 $ / 0,50 $, Sol 2 $ / 10 $, Astra 10 $ / 50 $
Outils intégrés Seulement si vous les appelez Web search environ 10 $ / 1 000 appels, plus le contenu récupéré facturé en tokens d’entrée
Conteneur environment.type vaut openai_hosted 1 / 4 / 16 / 64 Go environ 0,03 $ / 0,12 $ / 0,48 $ / 1,92 $ par 20 minutes et par conteneur. Les sessions éligibles sont à la minute, minimum 5 minutes
Votre serveur Il faut un processus résident, ou macOS L’Agents API ne contient pas cette ligne. Départs mensuels sur l’accueil : environ 101,7 $ (M4 16 Go / 256 Go) et 200,3 $ (24 Go / 512 Go)
La facture avant le prix unitaire

L’exemple public de création de session ne pose que openai_hosted. Il ne choisit pas un palier de mémoire. La page des prix facture pourtant quatre paliers de conteneur. Tant que la facture n’est pas arrivée, calculez 1 Go et 4 Go. Ne budgétez pas seulement la ligne la moins chère.

Construire le plus petit agent

L’entrée est POST /v1/agents/sessions, avec l’en-tête OpenAI-Beta: agents=v1. La clé a besoin de api.agents.read, api.agents.write et de api.responses.write pour l’inférence. Gardez la clé dans le processus qui envoie la requête. Ne mettez pas OPENAI_API_KEY dans l’environnement du sandbox. Les noms réservés comme PATH et CODEX_* sont refusés.

Plus petite session : Sol + openai_hosted
curl --no-buffer --fail-with-body https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-sol",
      "instructions": "Write clean code, run it, and report the actual output."
    },
    "environment": { "type": "openai_hosted" },
    "input": "Create tree.py, print a readable tree of the current directory, run it, show the output.",
    "stream": true
  }'

Commencez par gpt-6-sol. N’écrivez pas gpt-6-astra sur chaque session. Le critère d’acceptation tient en une phrase : il écrit un fichier, l’exécute, et relit la vraie sortie. Ne montez vers Astra que les cas difficiles déjà mesurés. Avec des sous-agents, les tokens s’additionnent par contexte d’agent. Ce n’est pas le prix d’un seul message utilisateur.

Limite de données pendant la bêta

La doc de bêta dit que l’Agents API ne prend pas en charge Zero Data Retention. Passer à self_hosted n’active pas ZDR. Si le code ou les clés ne peuvent pas quitter votre réseau, lisez les contrôles de données avant de créer une session.

Trois endroits dans le cloud

Déployer, ici, ne veut pas dire envelopper une autre plateforme. Cela répond à deux questions : qui appelle l’API, et sur quelle machine tournent les outils.

openai_hosted : scripts et vérifications

Le sandbox hébergé est un espace Linux avec Python, Node.js et un shell. Le répertoire de travail est /workspace. Il convient pour générer des scripts, traiter des données et vérifier des dépôts qui n’ont pas besoin de la chaîne Apple. Le réseau peut être resserré par tâche. Les exemples de la doc commencent souvent avec l’accès coupé, puis l’ouvrent une fois le script passé.

Des développeurs devant plusieurs écrans avec du code, pour faire tourner un agent sur une machine cloud qui reste allumée
Le processus qui appelle l’API doit rester éveillé. Un portable capot fermé ne sert qu’à valider la plus petite session.

Un processus qui reste éveillé

Un prototype peut envoyer ce curl depuis le portable devant vous. Fermer le capot coupe une longue session. En production, placez l’appel dans un processus qui ne dort pas : file, webhook ou minuteur. Ce processus peut être petit. Il ne compile pas iOS. Images personnalisées, GPU ou réseau privé vont sur self_hosted ou un environnement partenaire décrit dans la doc. Ne les forcez pas dans le sandbox hébergé. Les champs suivent la documentation développeur.

Quand il faut un Mac

Le sandbox hébergé est Linux. xcodebuild, le simulateur iOS, la signature et TestFlight exigent macOS. Laissez l’orchestration sur l’Agents API et la chaîne Apple sur un Cloud Mac. Scripts et contrôles front peuvent aller dans le sandbox. Archive et signature restent sur le Mac.

Le jour de la rédaction, les pastilles de prix de l’accueil indiquaient : M4 · 16 Go / 256 Go à partir de 101,7 $ par mois, M4 · 24 Go / 512 Go à partir de 200,3 $ par mois. Jour, semaine, mois et trimestre sont disponibles. Une acceptation courte se fait à la journée ou à la semaine, un build résident passe ensuite au mois. Le règlement suit la page des offres. Un prix de départ n’est pas ici un prix contractuel.

Ce que coûte l’API

Le tableau est en contexte court, dollars US par million de tokens. Au-dessus de 272K en entrée, toute la requête passe au contexte long : environ 2× pour l’entrée et le cache, environ 1,5× pour la sortie. Le supplément ne porte pas seulement sur le dépassement. Batch / Flex vaut environ la moitié du standard, Fast environ 2×. L’entrée en cache est moins chère. L’écriture de cache vaut environ 1,25× l’entrée non cachée.

PosteEntréeEntrée en cacheÉcriture de cacheSortie
gpt-6-luna · contexte court0,10 $0,01 $0,125 $0,50 $
gpt-6-sol · contexte court2 $0,20 $2,50 $10 $
gpt-6-astra · contexte court10 $1 $12,50 $50 $
gpt-6-astra · contexte long (>272K)20 $2 $25 $75 $
Web searchEnviron 10 $ / 1 000 appels, plus les tokens d’entrée du contenu récupéré
Conteneur 1 / 4 / 16 / 64 Go0,03 $ / 0,12 $ / 0,48 $ / 1,92 $ par 20 minutes (minimum 5 minutes si facturation à la minute)

Si une route est encore sur GPT-5.6 Sol, le tarif promo qui collait à la doc du 20 septembre était 4 $ en entrée et 20 $ en sortie, écrit jusqu’au 21 novembre. C’est une autre ligne de modèle. Ne l’ajoutez pas aux 2 $ / 10 $ de gpt-6-sol. Revérifiez la page des prix avant de mettre en production.

Ce que le serveur ajoute

  • Vous n’appelez que devant l’ordinateur. Le serveur coûte 0 $. Capot fermé, tout s’arrête. Un travail de nuit ne passe pas.
  • Un webhook doit tourner toute la journée, et chaque outil est dans le sandbox ou dans une API simple. L’orchestrateur est léger. Si une machine reste déjà allumée, ne louez pas un Mac seulement pour appeler l’Agents API.
  • Il vous faut macOS. Ajoutez un Cloud Mac. Le départ 16 Go sur l’accueil est d’environ 101,7 $ / mois. Il ne remplace pas les tokens. Il remplace l’étape qui ne tourne pas sans Mac.
Le loyer du Mac n’inclut pas l’API

Les deux paiements achètent des choses différentes. Le Mac peut être allumé, et les tokens de sortie Astra restent à 50 $ le million. Baissez le modèle par défaut vers Sol ou Luna avant de passer le Mac du jour au mois.

Une feuille mensuelle à modifier

C’est une feuille de calcul, pas un devis. Hypothèse : 22 jours ouvrés, 40 sessions par jour, soit 880. Chaque session est en contexte court, sans cache : 20 000 tokens d’entrée, 4 000 tokens de sortie, et une web search. Totaux : 17,6 M en entrée et 3,52 M en sortie.

PosteLunaSolAstra10 % Astra + 90 % Sol
Tokens du modèle3,52 $70,40 $352 $98,56 $
Web search (tokens de contenu exclus)8,80 $
Sandbox 5 min · 1 Go / 4 Go6,60 $ / 26,40 $
Sandbox 20 min · 1 Go / 4 Go26,40 $ / 105,60 $

Trois comparaisons, toujours sans les tokens du contenu récupéré :

  • Luna + recherche + 1 Go au plancher de 5 minutes : environ 19 $ (3,52 + 8,80 + 6,60).
  • Modèles mixtes + recherche + 20 minutes pleines à 1 Go : environ 134 $ (98,56 + 8,80 + 26,40).
  • Cette ligne plus le départ Cloud Mac 16 Go : environ 235 $ (134 + 101,7). Sans le Mac, le côté API reste autour de 134 $.

Pour votre volume, ne changez que trois nombres : le nombre de sessions, les tokens d’entrée par session, les tokens de sortie par session. La ligne de prix unitaire reste alignée sur la page des prix. Si 880 sessions deviennent 88, modèle, recherche et conteneur se divisent environ par 10. Le loyer du Mac, non.

FAQ

L’Agents API a-t-elle des frais de plateforme ?

L’annonce de bêta dit que non. Vous payez les tokens du modèle choisi, les outils intégrés que vous appelez vraiment, et la durée de conteneur seulement avec openai_hosted.

Quel modèle pour la boucle quotidienne ?

Le défaut est gpt-6-sol ou gpt-6-luna. Sur les mêmes 880 sessions, la ligne modèle tout-Astra est de 352 $. Quatre-vingt-dix pour cent Sol et dix pour cent Astra font 98,56 $. Ne promouvez un cas difficile qu’après une évaluation fixe.

Le sandbox hébergé peut-il lancer Xcode ?

Non. C’est Linux. Signature, simulateur et xcodebuild restent sur macOS. Un Cloud Mac couvre cette étape. Il ne remplace pas la facture API.

Où vit la clé d’API ?

Dans le processus qui appelle l’API, pas dans l’environnement du sandbox. La bêta ne prend pas en charge Zero Data Retention, et self_hosted n’est pas une exception.

Comment estimer un mois ?

Partez des 880 sessions ci-dessus et remplacez le nombre et les tokens. Prix des conteneurs à 1 Go et à 4 Go, et regardez à la fois le plancher de 5 minutes et un bloc de 20 minutes. Si le DevDay change un tarif, la page des prix l’emporte.

Faites passer la session, puis lisez les trois lignes

L’ordre est : plus petite session, trois lignes de facture, et seulement ensuite la question du Mac. Laissez le modèle par défaut sur Sol ou Luna. Gardez Astra pour les cas difficiles déjà mesurés. Sandbox Linux pour les scripts, macOS pour les archives. Ne demandez pas à une machine de remplacer l’autre, et ne fusionnez pas les deux factures en un seul « forfait mensuel agent ».

Les longs travaux ont besoin d’une machine qui reste allumée

Le portable sert à faire passer le curl. Les boucles d’agent de nuit, et xcodebuild, vont sur un Cloud Mac qui ne dort pas. Le portable ne lit que le diff et la facture.

Voir les offres Cloud Mac

Notes · Agents API

Les longs travaux ont besoin d’une machine qui reste allumée

Agents API · sandbox · Cloud Mac

Voir les offres Cloud Mac
Offre limitée Voir les offres