Construire avec CometAPIBesoin d'une seule API pour plusieurs modèles ?Testez le workflow dans Playground, puis créez une clé API lorsque le modèle et le coût correspondent à votre cas d'usage.
comment accéder à GPT-6.1 Terra de manière plus économique via CometAPI, et couvrir la configuration, des exemples de code, des stratégies de raisonnement, des bonnes pratiques, des comparaisons
GPT-6.1 Terra (gpt-6.1-terra) est le modèle GPT-6.1 milieu de gamme d’OpenAI, publié le 26 octobre 2026. Il offre un raisonnement visuel performant, une utilisation précise de l’ordinateur et une rédaction naturelle à la moitié du prix de GPT-6.1 Sol et GPT-5.6 Terra (1 $ en entrée / 5 $ en sortie par million de tokens, tarif standard). Avec une fenêtre de contexte de 1,05 M de tokens, un effort de raisonnement configurable (none à max), l’entrée image et la prise en charge complète des outils via l’API Responses, il est idéal pour des workflows agentiques à grand volume comme le traitement de factures, l’interprétation de plans techniques, l’interaction écran et la révision de documents. Ce guide couvre la configuration exacte, des exemples de code, des stratégies de raisonnement, les bonnes pratiques, des comparaisons et comment y accéder plus économiquement via CometAPI.
Points clés
ID du modèle : gpt-6.1-terra — fenêtre de contexte 1 050 000, 128 000 tokens de sortie max, date limite de connaissances 1er juin 2026.
Tarification (standard OpenAI) : 1 $ / 5 $ par 1 M de tokens en entrée/sortie ; entrée mise en cache 0,05 $ ; le long contexte (>272 K en entrée) et le mode Fast coûtent plus cher.
Revu pour la clarté, l'attribution des sources et la terminologie API actuelle.
Idéal pour les tâches visuelles + usage ordinateur ; surpasse nettement GPT-5.6 Terra tout en égalant ou approchant les modèles supérieurs à bien moindre coût et avec une vitesse plus élevée.
Préférez l’API Responses pour l’appel d’outils, l’usage ordinateur, les sorties structurées et le contrôle du raisonnement.
CometAPI propose le même modèle à tarif réduit (environ 0,80 $ / 4,00 $) avec une clé compatible OpenAI unique pour 500+ modèles, permettant un basculement facile et 20–40 % d’économies continues.
Qu’est-ce que GPT-6.1 Terra ?
GPT-6.1 Terra est le modèle rapide et efficace de milieu de gamme de la famille GPT-6.1, positionné entre le léger Luna et les niveaux plus puissants Sol/Astra. Le positionnement officiel met l’accent sur le raisonnement visuel détaillé, une utilisation précise de l’ordinateur (interaction écran, remplissage de formulaires, contrôle d’applications) et une écriture naturelle plus claire.
Il accepte des entrées texte et image et produit des sorties texte. Il ne prend pas en charge nativement l’entrée/sortie audio ou vidéo. Les capacités clés incluent le streaming, les sorties structurées, l’appel de fonctions, la mise en cache des prompts, la recherche web, la recherche de fichiers, l’usage ordinateur, l’interpréteur de code, et plus encore—principalement via l’API Responses.
OpenAI met en avant des gains majeurs par rapport à GPT-5.6 Terra : meilleurs scores à Agents’ Last Exam (tâches professionnelles d’usage ordinateur) pour environ un tiers du coût, quasi-parité avec GPT-6 Astra sur certains benchmarks visuels et agentiques à environ 1/10e du prix par token, taux d’hallucinations nettement plus faibles et plus de 3× plus rapide que Sol ou Astra sur les charges de travail pertinentes.
Spécifications et tarification de GPT-6.1 Terra
Spécification
Détails
ID du modèle
gpt-6.1-terra
Fenêtre de contexte
1 050 000 tokens
Tokens d’entrée max
~922 000
Tokens de sortie max
128 000
Date limite connaissances
1er juin 2026
Modalités d’entrée
Texte, Image
Modalités de sortie
Texte
Niveaux d’effort de raisonnement
none, low, medium (par défaut), high, xhigh, max
Endpoints pris en charge
Chat Completions, Responses, Batch
Fine-tuning
Non pris en charge
Tarification standard OpenAI (par 1 M de tokens)
Entrée : 1,00 $
Entrée mise en cache : 0,05 $
Écritures de cache (rétention 30 min) : 1,25 $
Sortie : 5,00 $
Notes : Les prompts dépassant 272 K tokens d’entrée entraînent un coût ×2 pour l’entrée/le cache et ×1,5 pour la sortie sur toute la requête. Batch/Flex sont 50 % moins chers ; le mode Fast coûte ×2. Des surcoûts régionaux peuvent s’appliquer.
CometAPI liste actuellement GPT-6.1 Terra à environ 0,80 $ en entrée / 4,00 $ en sortie (à confirmer sur le tableau de bord), ce qui procure des économies significatives tout en offrant un endpoint unifié compatible OpenAI.
Comment configurer l’API GPT-6.1 Terra
Directement via OpenAI
Créez ou utilisez un projet OpenAI avec accès API (palier Build et au‑dessus ; le palier Free n’est pas pris en charge pour ce modèle).
Générez une clé API et stockez‑la en sécurité (variable d’environnement ou gestionnaire de secrets).
Installez le dernier SDK OpenAI : pip install --upgrade openai (Python) ou npm install openai (Node.js).
Via CometAPI (recommandé pour la plupart des usages en production et multi-modèles)
Comment accéder à l’API GPT-6.1 Terra dans CometAPI ?
Compte et identifiants
Connectez‑vous sur CometAPI, générez une clé API et confirmez que gpt-6.1-terra est disponible. Stockez l’identifiant comme variable d’environnement, pas dans le code source de votre application.
Une clé CometAPI authentifie les requêtes vers CometAPI. Conservez‑la dans votre environnement de développement ou votre backend ; ne l’intégrez pas à une page web publique et ne la validez pas dans le dépôt. La variable d’environnement doit être disponible dans le terminal qui exécute votre script.
Set the key in Bash.
export COMETAPI_KEY="your_cometapi_api_key"
Sur Windows, définissez la même variable dans PowerShell.
$env:COMETAPI_KEY="your_cometapi_api_key"
Une première requête petite et ciblée
Utilisez une courte invite texte et une réponse avant d’ajouter des données image, un schéma JSON ou des fonctions. Confirmez l’accès au modèle et l’URL de base https://api.cometapi.com/v1. Si votre compte propose plusieurs routes, choisissez celle dont la documentation couvre les fonctionnalités dont vous avez besoin.
Comment utiliser une réponse de l’API GPT-6.1 Terra ?
Envoyer la première requête texte
Ajoutez le code suivant après la configuration du client et enregistrez le script combiné sous first_request.py. Il demande une réponse courte, vérifie l’achèvement, et écrit le texte dans un fichier UTF‑8.
Générez une réponse texte, vérifiez l’achèvement et enregistrez answer.txt.
from pathlib import Path
response = client.responses.create(
model="gpt-6.1-terra",
instructions="Vous êtes un assistant de rédaction technique concis.",
input="Résumez trois causes courantes d’échec des intégrations d’API et leurs correctifs.",
reasoning={"effort": "medium"},
max_output_tokens=2000,
)
if response.status != "completed":
raise RuntimeError(
f"Statut de la réponse : {response.status}; "f"détails : {response.incomplete_details}"
)
ifnot response.output_text.strip():
raise RuntimeError("Aucun texte renvoyé ; inspectez response.output")
Path("answer.txt").write_text(response.output_text, encoding="utf-8")
print(response.output_text)
print("answer.txt enregistré")
print(response.usage)
Run the combined client-and-request script.
python first_request.py
Vérifier la réponse enregistrée
Ouvrez answer.txt et confirmez que la réponse traite la demande et contient les trois causes et correctifs requis. Une réponse d’API marquée comme terminée établit que la génération est achevée ; votre application doit néanmoins vérifier si le contenu répond à ses exigences. Conservez l’enregistrement d’usage renvoyé si vous comparez les coûts des requêtes.
Utiliser cURL pour une vérification HTTP directe
Pour une vérification rapide de l’endpoint sans SDK, exécutez cette commande dans Bash avec COMETAPI_KEY défini. Inspectez le JSON renvoyé, incluant status, output et usage. Ne supposez pas que le premier élément de sortie contienne toujours le texte final.
curl -sS https://api.cometapi.com/v1/responses \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-terra","input":"Expliquez comment l’IA peut réduire les erreurs de traitement des factures en 100 mots.","reasoning":{"effort":"medium"},"max_output_tokens":600}'
Choisir les paramètres de requête
Utilisez les champs de requête Responses ci‑dessous comme référence compacte. Commencez par le modèle, l’entrée et un budget de sortie modeste ; ajoutez un format ou des outils uniquement lorsque le workflow l’exige.
Paramètre
Usage dans ce tutoriel
model
Sélectionner gpt-6.1-terra.
input
Passer une invite, des messages, des images ou des éléments de conversation.
instructions
Définir le comportement et les exigences de sortie.
reasoning.effort
Choisir none, low, medium (par défaut), high, xhigh ou max.
max_output_tokens
Limiter le budget combiné de raisonnement et de sortie visible.
stream
Recevoir des événements de manière incrémentale.
text.format
Demander un format de sortie structuré.
tools
Déclarer des fonctions appelables.
Choisissez low pour une tâche d’extraction simple, ou commencez par medium pour l’analyse de documents. Augmentez l’effort lorsque vos propres exemples montrent une amélioration utile. Conformément aux règles de compatibilité des paramètres GPT-6, omettez temperature, top_p et top_logprobs lorsque effort n’est pas none.
Les tokens de raisonnement sont décomptés du budget de sortie. Si la réponse est incomplète, inspectez son status et incomplete_details avant de l’analyser ou de l’afficher. Le guide sur les tokens de raisonnement explique pourquoi un petit max_output_tokens peut être consommé avant qu’une réponse visible complète ne soit renvoyée.
Contrôler l’effort de raisonnement
Choisissez l’effort de manière réfléchie pour équilibrer qualité, latence et coût :
none : Le plus rapide, pour l’extraction/la classification simples.
low : Tâches routinières.
medium (par défaut) : La plupart des travaux mixtes ou multi‑étapes.
high / xhigh / max : Discrepances visuelles complexes, planification ou tâches à fort enjeu—à utiliser uniquement lorsque les évaluations justifient les tokens/latences supplémentaires.
Chat Completions fonctionne pour le texte/l’image sans outils, mais l’appel d’outils et certaines fonctionnalités avancées nécessitent Responses.
Comment l’API GPT-6.1 Terra peut-elle analyser des images ?
Le modèle accepte des images en plus du texte. Cela prend en charge l’interprétation de captures d’écran, l’extraction de documents, la revue de plans techniques et la comparaison de supports visuels. La documentation sur l’entrée vision d’OpenAI spécifie le bloc de contenu input_image.
Analyser une image de facture locale avec Python
Placez invoice.png dans le répertoire de travail.
Encodez un PNG local et envoyez‑le avec une invite d’extraction de facture. Terra excelle pour l’association de photos de produits, les plans techniques, les captures d’écran et la QA visuelle.
response = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "medium"},
input=[{
"role": "user",
"content": [
{"type": "input_text", "text": "Examinez cette image de campagne. Listez uniquement les problèmes visibles de recadrage, placement du texte, contraste et zone de sécurité du logo. Indiquez les zones et proposez des corrections."},
{"type": "input_image", "image_url": "https://example.com/image.jpg", "detail": "high"}
]
}]
)
print(response.output_text)
Les formats pris en charge incluent PNG, JPEG, WEBP, GIF non animé. Utilisez detail: "high" ou "low" de manière appropriée ; un niveau de détail plus élevé consomme plus de tokens. Les URL de données Base64 sont également prises en charge.
Appel d’outils, usage ordinateur et sorties structurées
L’appel d’outils (appel de fonctions, usage ordinateur, recherche web, recherche de fichiers, interpréteur de code, MCP, etc.) nécessite l’API Responses.
Bonnes pratiques pour l’usage ordinateur :
Exécuter dans un environnement isolé (navigateur/VM).
Appliquer des listes d’autorisations strictes pour les sites/actions.
Exiger une approbation humaine pour les actions à fort impact (achats, suppressions, export de données).
Définir des limites de pas/temps/coût.
Vérifier l’état final plutôt que de se fier uniquement au résumé du modèle.
Considérer le contenu de la page comme non fiable (une forte résistance au prompt injection est revendiquée, mais la défense en profondeur reste essentielle).
Faut-il utiliser Responses ou Chat Completions ?
Pour GPT-6.1 Terra, Chat Completions prend en charge les requêtes texte et image sans outils. L’appel d’outils nécessite Responses, également recommandé pour les workflows agentiques multi‑étapes, la gestion d’état de conversation, la préservation du contexte de raisonnement à travers les appels d’outils et les événements de streaming avancés. Utilisez Responses pour les exemples ci‑dessous et pour les workflows qui dépendent de ses fonctionnalités de sorties structurées ou de gestion d’état. Une passerelle compatible doit aussi prendre en charge l’endpoint et les champs que vous envoyez. Voir le guide de migration officiel.
Lors de la migration d’une intégration existante, vérifiez trois choses avant de rediriger le trafic : l’ID du modèle, l’endpoint et vos paramètres de requête. Une requête Chat Completions avec outils doit être réimplémentée avec Responses ; changer uniquement le nom du modèle ne suffit pas. Dans Responses, utilisez reasoning.effort ; dans Chat Completions, utilisez reasoning_effort.
Tableau comparatif : GPT-6.1 Terra vs modèles associés
Aspect
GPT-6.1 Terra
GPT-6.1 Sol
GPT-5.6 Terra
GPT-6 Astra (env.)
Positionnement
Milieu de gamme, usage visuel/ordinateur à grand volume
Capacité supérieure
Milieu de gamme précédent
Frontier
Prix standard (entrée/sortie)
1 $ / 5 $
~2 $ / 10 $
~2 $ / 12 $
Beaucoup plus élevé
Contexte
1,05 M
Similaire
Similaire
Similaire
Vitesse sur tâches d’agent
La plus rapide du groupe
Plus lent
Plus lent
Plus lent
Agents’ Last Exam
Fort (+15 pts vs 5.6 à medium)
Plus fort en code difficile
Baseline
Comparable ou légèrement meilleur
Meilleurs cas d’usage
Agents à grand volume, QA visuelle, formulaires
Codage/raisonnement complexes
Hérité
Capacité la plus élevée
Gérer les erreurs dans un workflow API GPT-6.1 Terra
Distinguez d’abord une requête nécessitant une correction d’une panne temporaire de connexion ou de service. Repartez de la plus petite requête fonctionnelle lors du diagnostic de paramètres optionnels, et conservez les détails d’erreur dans des logs côté serveur sans inclure la clé API.
Échec d’authentification ou d’accès : vérifiez la clé, l’hôte de destination, l’accès du compte et le solde disponible avant de réessayer.
Paramètre non pris en charge : supprimez les champs optionnels, confirmez l’endpoint et le modèle, puis ajoutez un champ à la fois.
Génération incomplète : inspectez status et incomplete_details ; ajustez le budget de sortie ou simplifiez la tâche avant de consommer le résultat.
Limite de débit ou échec transitoire : utilisez un backoff borné et une limite de tentatives. Les réessais peuvent générer une autre réponse facturable.
Flux interrompu : conservez le texte partiel comme sortie interrompue. Ne le considérez pas comme une réponse complète et n’exécutez pas d’action basée sur une requête d’outil partielle.
Échec d’un outil ou en aval : vérifiez la réponse enregistrée et les enregistrements d’opérations avant de répéter un business
Conclusion
GPT-6.1 Terra représente un bond pratique pour les développeurs qui construisent des agents visuels et d’usage ordinateur à grand volume. Sa combinaison de capacités améliorées, d’une efficacité‑coût nettement meilleure et d’un raisonnement configurable en fait le choix par défaut pour de nombreuses charges de production qui nécessitaient auparavant des modèles plus coûteux.
Commencez avec l’API Responses, démarrez à un effort de raisonnement medium, imposez des sorties structurées et des garde‑fous de sécurité, et routez le trafic via une plateforme unifiée comme CometAPI pour un coût et une flexibilité optimaux. Avec la configuration et les schémas présentés ci‑dessus, vous pouvez passer de zéro à une intégration prête pour la production en quelques minutes tout en maîtrisant les coûts à long terme.
Pour la tarification, les limites de débit et la disponibilité des fonctionnalités les plus récentes, recoupez toujours la documentation officielle d’OpenAI et votre tableau de bord CometAPI. Bonne construction !
FAQs
Plusieurs utilisateurs peuvent-ils partager une conversation de l’API GPT-6.1 Terra ?
Isolez l’historique des conversations par utilisateur ou espace de travail autorisé. Un backend partagé peut détenir la clé API, mais cela ne donne pas à chaque utilisateur l’autorisation de lire chaque conversation. Avant de charger des messages antérieurs ou des résultats stockés, vérifiez que l’utilisateur actuel peut accéder à cette conversation. Pour les workflows collaboratifs, définissez qui peut voir et prolonger l’historique partagé.
Un même prompt de l’API GPT-6.1 Terra renverra-t-il un texte identique ?
Ne comptez pas sur une sortie strictement identique entre générations répétées. Conservez le prompt, l’ID du modèle, les paramètres et le résultat accepté lorsque la reproductibilité est importante. Si un workflow a besoin exactement de la même formulation validée plus tard, récupérez la réponse enregistrée au lieu de régénérer. Évaluez une nouvelle réponse par rapport aux exigences de la tâche plutôt que de considérer les différences de formulation comme un échec en soi.
store=False définit-il la politique de confidentialité de l’ensemble du workflow API ?
Non. Un paramètre de stockage au niveau de la requête ne décrit pas chaque journal, cache ou politique de rétention à travers votre application et votre passerelle API. Examinez les conditions et les contrôles de données applicables à chaque service avant d’envoyer des documents confidentiels. Limitez les données soumises et évitez d’enregistrer du contenu sensible des prompts dans les logs applicatifs uniquement pour faciliter le débogage.
Comment obtenir une clé API GPT-6.1 Terra ?
Vous pouvez accéder à l’API GPT-6.1 Terra via CometAPI. Créez un compte, générez une clé API et configurez votre SDK avec l’URL de base https://api.cometapi.com/v1 et l’ID de modèle gpt-6.1-terra. Aucune clé API OpenAI distincte n’est requise.
Combien coûte l’API GPT-6.1 Terra ?
Au 28 octobre 2026, la tarification officielle d’OpenAI est de 1,00 $ par million de tokens en entrée, 0,05 $ par million de tokens d’entrée mis en cache, et 5,00 $ par million de tokens en sortie. Les tarifs publiés par CometAPI sont de 0,80 $ pour l’entrée et 4,00 $ pour la sortie, soit environ 20 % de moins. Pour 10 000 tokens d’entrée non mis en cache et 2 000 tokens de sortie, le coût estimé est de 0,016 $ via CometAPI contre 0,020 $ via OpenAI, hors frais additionnels.
L’API GPT-6.1 Terra est-elle gratuite ?
Non. Selon la documentation des modèles d’OpenAI, GPT-6.1 Terra n’est pas disponible sur le palier API Free et est accessible à partir du palier Build payant. Les utilisateurs ChatGPT Plus, Pro, Enterprise et Edu peuvent accéder à Terra via ChatGPT Work et Codex, mais l’utilisation API est facturée séparément des abonnements ChatGPT. Alternativement, les développeurs peuvent accéder à GPT-6.1 Terra via CometAPI avec une clé API valide et des crédits suffisants, sous réserve de disponibilité du fournisseur.
