Note de l’auteur : suivez les étapes dans la console pour connecter l’API GPT-6.1 Terra en 5 étapes. Vous découvrirez comment choisir le point de terminaison, éviter les pièges liés aux paramètres et comprendre la tarification par paliers à 272K.
En bref : pour connecter GPT-6.1 Terra, il faut surtout choisir entre Responses et Chat Completions. Si vous avez besoin d’appels d’outils, vous devez utiliser Responses. Sinon, vous pouvez reprendre votre code existant presque tel quel : il suffit de changer le nom du modèle.
GPT-6.1 Terra a été lancé le 26 octobre 2026. Son identifiant est gpt-6.1-terra. La documentation officielle précise déjà les points de terminaison, les paramètres et les règles de tarification : ces informations sont vérifiables. Cet article suit l’ordre des opérations dans la console : inscription → création d’un jeton → recherche de l’URL de base → saisie du nom du modèle → premier appel. Chaque étape est accompagnée d’un critère de validation. Les commandes en ligne de commande et les exemples de code sont proposés en option.
L’essentiel : à la fin de cet article, vous saurez vérifier toute la chaîne de connexion à l’API GPT-6.1 Terra depuis la console et éviter les erreurs 400 les plus fréquentes.
📌 État actuel de la plateforme : au 27 octobre 2026,
gpt-6.1-terrane figure pas encore dans la liste des modèles disponibles sur APIYI (apiyi.com). Nous proposerons ce modèle dès que possible. Les modèles de la même génération —gpt-6-astra,gpt-6-sol,gpt-6.1-soletgpt-6-luna— sont déjà disponibles. Vous pouvez commencer par utilisergpt-6.1-solpour vérifier la chaîne de connexion. Consultez la liste des modèles de la plateforme pour connaître les modèles disponibles et leurs tarifs.
Points clés de l’API GPT-6.1 Terra
| Point clé | Description | Ce que cela implique pour vous |
|---|---|---|
| ID du modèle | gpt-6.1-terra, publié le 26 octobre 2026 |
Renseignez cette valeur dans le champ model de la requête |
| Points de terminaison disponibles | Responses, Chat Completions et Batch | Les points de terminaison Realtime, Assistants, Embeddings, etc. ne sont pas pris en charge |
| Appels d’outils | Seul Responses les prend en charge | Une requête envoyée à Chat avec des outils échouera directement |
| Contexte | 1 050 000 jetons au total, 922 000 jetons en entrée par requête et 128 000 en sortie | Adapté aux longs documents, mais attention au palier de tarification à 272 K |
| Modalités | Texte et images en entrée, texte en sortie | Pour les images, utilisez input_image avec Responses |
| Date limite des connaissances | 1er juin 2026 | Pour obtenir des informations plus récentes, utilisez l’outil web_search |
Limites des capacités de GPT-6.1 Terra
GPT-6.1 Terra prend en charge le streaming, les sorties structurées, les appels de fonctions, file_search, l’entrée d’images, la recherche sur le Web et la mise en cache des invites. En revanche, il ne prend pas en charge le réglage fin ni les sorties prédites. Si votre ancien projet dépend de modèles affinés ou de sorties prédites, vous ne pourrez pas le migrer directement.
Le point de terminaison Responses permet d’utiliser de nombreux outils, notamment web_search, file_search, image_generation, code_interpreter, hosted_shell, apply_patch, skills, computer_use, mcp et tool_search. C’est la raison principale pour laquelle il faut choisir Responses si vous avez besoin d’outils : avec ce modèle, Chat Completions se limite aux conversations sans outils.
Comment appeler l’API GPT-6.1 Terra : le parcours en 5 étapes dans la console
Étape 1 : créer un compte
- Rendez-vous sur APIYI, à l’adresse apiyi.com, puis suivez les instructions à l’écran pour créer un compte avec vos propres informations. La plateforme exige que chacun crée son propre compte.
- Les nouveaux comptes bénéficient d’un crédit d’essai de 0,05 USD. Vous pouvez donc effectuer un premier appel léger sans recharger votre compte.
- Critère de validation : après vous être connecté, ouvrez la console et vérifiez que le crédit d’essai apparaît dans la page du portefeuille ou du solde.
- En cas de blocage : si le crédit n’apparaît pas, vérifiez d’abord que vous avez terminé la procédure d’inscription avant de recharger votre compte.
Pour passer par le canal officiel, créez une clé dans la page API Keys de la plateforme OpenAI. Votre compte doit se trouver dans une région prise en charge et être approvisionné au niveau Build, c’est-à-dire avec au moins 5 USD.
Étape 2 : créez un jeton et choisissez le bon groupe
- Accédez à la page des jetons dans la console, à l’adresse
api.apiyi.com/token, puis cliquez sur « Créer un jeton ». - Choisissez un groupe dans la liste « Sélectionner un groupe ». Le groupe détermine les modèles disponibles, le coefficient de facturation et la route amont.
defaultetsvipsont au même tarif que l’offre officielle ;CodexReverseutilise des ressources issues de la rétro-ingénierie. - Critère de validation : une fois le jeton enregistré, une clé commençant par
sk-apparaît dans la liste. - En cas de blocage : le « Groupe » défini au niveau du compte ne correspond pas au groupe du jeton. C’est le groupe choisi pour le jeton qui est réellement pris en compte.
Étape 3 : trouvez l’URL de base
L’URL de base dépend du SDK utilisé : c’est le paramètre qu’on renseigne le plus souvent incorrectement.
- SDK OpenAI :
https://api.apiyi.com/v1— le chemin/v1est obligatoire. - SDK Anthropic : utilisez le domaine racine, sans
/v1. - SDK Google GenAI : utilisez le domaine racine et définissez
api_versionsurv1beta.
Critère de validation : pour la série GPT-6.1, utilisez le SDK OpenAI ou un client compatible avec OpenAI. L’adresse renseignée doit se terminer par /v1. En cas de blocage : si vous obtenez une erreur 404, dans la grande majorité des cas, c’est parce que /v1 a été oublié ou ajouté deux fois.
Étape 4 : renseigner le nom du modèle
Dans le champ du modèle de votre client ou outil de débogage, renseignez l’ID du modèle. Nous vous conseillons de commencer par un modèle léger comme gpt-5.4-mini pour vérifier que tout fonctionne, puis de passer à gpt-6.1-sol. Lorsque gpt-6.1-terra sera disponible sur la plateforme, il suffira de modifier un seul champ. La plateforme ne propose pas de routage gratuit sous des formes comme auto ou auto:free : n’essayez pas de les utiliser.
Critère de validation : le nom du modèle doit correspondre exactement à celui qui figure dans la liste des modèles de la plateforme. En cas de problème : si le modèle est introuvable, vérifiez d’abord son orthographe dans la liste, puis assurez-vous que le groupe associé au jeton inclut bien ce modèle.
Étape 5 : effectuer votre première requête
Voici un exemple minimal fonctionnel, avec plusieurs options au choix :
- Définir la variable d’environnement :
export OPENAI_API_KEY=sk-你的令牌 - Créer le client :
client = OpenAI(base_url="https://api.apiyi.com/v1"); la clé est automatiquement récupérée depuis la variable d’environnement - Utiliser Responses :
r = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "low"}, max_output_tokens=800) - Utiliser Chat :
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "简洁回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800) - Afficher les résultats pour vérification :
print(c.model, c.usage.prompt_tokens)
Critère de validation : la requête renvoie le code HTTP 200 et usage.prompt_tokens contient une valeur numérique (pour Responses, vérifiez usage.input_tokens). Après avoir remplacé le modèle par gpt-6.1-terra, vérifiez que le champ model de la réponse indique bien ce nom.
🚀 Démarrage rapide : nous vous conseillons de tester
gpt-6.1-solsur APIYI, à l’adresse apiyi.com, avec le crédit d’essai. Vous pourrez ainsi vérifier que la clé, le groupe et l’URL de base sont correctement configurés. Une fois Terra disponible, il suffira de modifier le nom du modèle pour basculer. Consultez la liste des modèles de la plateforme pour connaître les modèles disponibles et leurs tarifs.
| Étape | Action dans la console | Critère de validation | Première vérification en cas de problème |
|---|---|---|---|
| 1. Inscription | Créez votre compte et connectez-vous | Un crédit d’essai de 0,05 $ est visible | Vérifiez que l’inscription est terminée |
| 2. Jeton | Créez un jeton et sélectionnez un groupe | La liste affiche une clé commençant par sk- |
Vérifiez que vous ne confondez pas le groupe du jeton et celui de l’utilisateur |
| 3. URL de base | Dans le SDK OpenAI, renseignez l’adresse se terminant par /v1 |
L’adresse se termine par /v1 |
En cas d’erreur 404, vérifiez la présence de /v1 |
| 4. Nom du modèle | Renseignez un modèle comme gpt-6.1-sol |
Le nom correspond exactement à celui de la liste des modèles | Vérifiez l’orthographe et les modèles inclus dans le groupe |
| 5. Requête | Effectuez votre premier appel | La réponse renvoie le code 200 et usage contient une valeur numérique | Vérifiez le code d’état, le corps de la réponse et x-request-id |
Vous pouvez aussi choisir Magpie pour une intégration encore plus simple. Il suffit de renseigner la clé et l’URL de base dans son interface graphique. Magpie connecte automatiquement des agents de programmation comme Claude Code, Codex, Pi ou Hermes à la même passerelle, sans avoir à modifier leurs fichiers de configuration un par un.
Choisir un endpoint pour l’API GPT-6.1 Terra : Responses ou Chat Completions
| Critère | Responses (v1/responses) | Chat Completions (v1/chat/completions) |
|---|---|---|
| Appels d’outils | Oui, avec 10 catégories d’outils intégrés | Non, la présence de tools provoque une erreur |
| Instructions système | instructions |
Le rôle developer dans messages, plus fiable que system |
| Niveau de raisonnement | reasoning: {effort: ...} |
reasoning_effort |
| Limite de sortie | max_output_tokens |
max_completion_tokens |
| Format d’entrée | Chaîne ou tableau de messages ; les images utilisent input_image |
Tableau messages |
| Reprise sur plusieurs tours | include: ["reasoning.encrypted_content"], puis renvoyer à l’identique la sortie du tour précédent |
Historique des messages à reconstituer manuellement |
| Usage en streaming | Renvoyé par défaut | Nécessite stream_options: {include_usage: true} |
Comparaison avec Chat Completions : l’endpoint Chat est particulièrement avantageux pour assurer la compatibilité avec le code existant : dans la plupart des projets, il suffit de changer le nom du modèle pour que tout fonctionne. En revanche, sur Terra, il ne permet pas d’appeler des outils, et certains groupes ignorent les messages system. Responses prend en charge nativement les outils et la reprise du raisonnement chiffré ; il convient donc mieux à la création d’agents et aux scénarios de raisonnement sur plusieurs tours.
Le niveau de raisonnement comporte six options : none, low, medium (par défaut), high, xhigh et max. Il n’existe pas d’option minimal. Les tokens de raisonnement sont comptabilisés dans la facturation et la limite de sortie. Il faut donc prévoir une marge avec max_output_tokens : sinon, la sortie risque d’être tronquée avant la fin du raisonnement.
Les trois pièges des paramètres de l’API GPT-6.1 Terra
| Piège | Écriture incorrecte | Écriture correcte | Conséquence |
|---|---|---|---|
| Chat avec tools | Transmettre tools dans chat.completions | Utiliser le point de terminaison Responses | Échec de la requête |
| Ancien paramètre | Transmettre max_tokens avec Chat |
Utiliser max_completion_tokens à la place |
Erreur 400 |
| Conflit des paramètres d’échantillonnage | Transmettre temperature ou top_p lorsque effort n’est pas égal à none | Supprimer temperature, top_p et top_logprobs ; avec Chat, supprimer aussi logprobs | Erreur 400 |
En plus de ces trois pièges, la documentation officielle recense plusieurs autres cas susceptibles de provoquer une erreur 400 : la valeur minimal pour effort, une valeur invalide pour prompt_cache_options.ttl ou une entrée dépassant 922 000 tokens. Les liens des images en entrée doivent être accessibles au serveur. Les sites qui bloquent les robots d’exploration peuvent faire échouer la requête ; dans ce cas, une URL de données base64 est plus fiable.
Pour diagnostiquer une erreur, gardez en tête un point essentiel : le message d’erreur complet n’apparaît qu’une seule fois, dans le corps de la réponse. Les journaux du système sont un registre de facturation, et les appels échoués n’y sont pas comptabilisés. Conservez donc le code d’état HTTP, le corps complet de la réponse brute et l’en-tête x-request-id. N’appelez pas raise_for_status() avant de lire le corps : vous perdriez le message d’erreur.
Tarifs de l’API GPT-6.1 Terra et seuil de 272K
Voici les tarifs officiels, en dollars par million de tokens. Attention : le palier s’applique à la requête entière. Dès que l’entrée dépasse 272K, tous les éléments facturés pour cette requête passent au deuxième palier.
| Élément facturé | Entrée ≤ 272K | Entrée > 272K |
|---|---|---|
| Entrée | 1 | 2 |
| Sortie (tokens de raisonnement inclus) | 5 | 7,5 |
| Lecture du cache | 0,05 | 0,1 |
| Écriture dans le cache (30 minutes) | 1,25 | 2,5 |
| Écriture dans le cache (12 heures) | 2,50 | 5 |
Pour estimer le coût, prenez en compte les quatre éléments : l’entrée, la sortie, la lecture du cache et l’écriture dans le cache. Cette dernière dépend aussi de la durée choisie : 30 minutes ou 12 heures. Ne tenir compte que des tarifs d’entrée et de sortie conduit à sous-estimer le coût des scénarios combinant un long contexte et la mise en cache. Sur la plateforme, les modèles de la même génération déjà disponibles appliquent exactement les mêmes tarifs que le site officiel pour chacun des quatre éléments, avec les mêmes deux paliers, appliqués à la requête entière.
Les limites de débit officielles de l’offre Standard sont les suivantes : Build, 5 000 RPM / 1 million de TPM ; Launch, 10 000 RPM / 4 millions de TPM ; Grow, 15 000 RPM / 40 millions de TPM.
💰 Conseil pour réduire les coûts : pour les tâches sur de longs documents, essayez de limiter chaque entrée à 272K et combinez cette approche avec la mise en cache des invites : vous pouvez ainsi réduire nettement le tarif. En choisissant le groupe
defaultousvipsur APIYI, apiyi.com, vous bénéficiez d’une facturation au même tarif que le site officiel. Consultez la liste des modèles de la plateforme pour connaître les modèles et tarifs disponibles.
Rappel de sécurité pour l’API GPT-6.1 Terra
Stockez votre clé API dans une variable d’environnement ou un service de gestion des secrets. Ne l’inscrivez jamais en dur dans le code source et ne la poussez surtout pas dans un dépôt Git. Il est conseillé d’exclure les fichiers .env dans .gitignore. Si votre clé est compromise, supprimez-la immédiatement depuis la page des jetons et créez-en une nouvelle.
Veillez également à choisir le bon groupe pour votre jeton : une erreur peut entraîner un message indiquant que le modèle n’est pas disponible ou, pire, une facturation appliquant un multiplicateur inattendu. Utilisez de préférence un jeton différent pour chaque projet afin de gérer séparément les quotas et de pouvoir les désactiver individuellement.
Foire aux questions
Q1 : Qu’est-ce que GPT-6.1 Terra ?
OpenAI a publié ce modèle le 2026-10-26. Son identifiant est `gpt-6.1-terra`. Sa fenêtre de contexte est de 1 050 000 tokens. Il accepte le texte et les images en entrée, et produit du texte. Vous pouvez l’appeler via les trois points de terminaison Responses, Chat Completions et Batch.
Q2 : Comment choisir entre Responses et Chat Completions pour GPT-6.1 Terra ?
Pour utiliser des outils, comme function calling ou web_search, choisissez Responses. Pour de simples conversations, Chat convient aussi, mais vous devez utiliser max_completion_tokens et ne pas inclure de tools.
Q3 : Peut-on déjà appeler gpt-6.1-terra avec APIYI ?
Au 2026-10-27, le modèle n’est pas encore disponible. Nous ferons le nécessaire pour le proposer rapidement. En attendant, vous pouvez vérifier votre intégration avec le modèle de la même génération `gpt-6.1-sol` sur APIYI apiyi.com. Consultez la liste des modèles de la plateforme pour connaître les modèles disponibles et leurs tarifs.
Q4 : Pourquoi reçoit-on une erreur 400 quand on transmet temperature ?
Lorsque le niveau de raisonnement est différent de none, vous ne pouvez pas transmettre temperature, top_p ou top_logprobs. Supprimez ces paramètres ou définissez effort sur none.
Q5 : Peut-on faire un test sans recharger son compte ?
Oui. Les nouveaux comptes créés sur APIYI apiyi.com disposent d’un crédit d’essai de 0,05 dollar, suffisant pour effectuer un appel simple et vérifier que tout fonctionne. Nous vous conseillons de tester d’abord avec `gpt-5.4-mini`, puis de passer au modèle souhaité.
Q6 : Quelles sont les limites connues de GPT-6.1 Terra ?
Le modèle ne prend pas en charge le réglage fin ni les sorties prédites. Les points de terminaison Realtime, Assistants, Embeddings, Images et Audio ne sont pas pris en charge non plus. Au-delà de 272K tokens en entrée, l’ensemble de la requête est facturé au tarif de la deuxième tranche. Au-delà de 922 000 tokens, l’API renvoie directement une erreur 400.
Points clés de l’API GPT-6.1 Terra
- Le seul choix déterminant : pour utiliser des outils, choisissez Responses ; sinon, avec Chat, il suffit de changer le nom du modèle.
- Trois pièges liés aux paramètres : n’incluez pas
toolsavec Chat, utilisezmax_completion_tokenset, sieffortn’est pas défini surnone, ne transmettez pas de paramètres d’échantillonnage. - Configuration en 5 étapes dans la console : créez un compte, générez un jeton et choisissez un groupe, ajoutez
/v1à l’URL de base, indiquez le nom du modèle, puis envoyez une requête. - Signes que tout fonctionne : la clé commence par
sk-, la requête renvoie le code 200,usagecontient des valeurs numériques et le champmodelreprend le nom du modèle. - Quatre éléments à prendre en compte pour le prix : les jetons d’entrée, les jetons de sortie, la lecture du cache et l’écriture dans le cache. Au-delà de 272K, toute la requête passe dans la deuxième tranche tarifaire.
- Pour démarrer : testez d’abord
gpt-6.1-solsur APIYI, puis, une fois Terra disponible, changez simplement le nom du modèle.
En résumé
L’intégration de l’API GPT-6.1 Terra repose sur trois points :
- Choisissez d’abord le point de terminaison : Responses ou Chat. Ce choix détermine la syntaxe des paramètres et la possibilité d’utiliser des outils.
- Vérifiez chaque étape : le jeton, l’URL de base, le nom du modèle et la première requête ont chacun un indicateur de bon fonctionnement.
- Anticipez les coûts : le seuil de 272K s’applique à la requête entière. Pensez à inclure les quatre frais liés au cache dans votre budget.
Nous vous recommandons de commencer par tester l’ensemble du processus avec gpt-6.1-sol sur APIYI (apiyi.com). Au 27 octobre 2026, gpt-6.1-terra n’est pas encore disponible sur la plateforme. Nous le proposerons dès que possible ; les modèles et les prix affichés dans la liste de la plateforme feront foi.
📚 Sources de référence
- Page des modèles OpenAI – GPT-6.1 Terra : spécifications du modèle et prise en charge des points de terminaison
- Lien :
platform.openai.com/docs/models/gpt-6.1-terra -
À consulter pour les informations officielles sur le contexte, les modalités et les outils disponibles
-
Guide des derniers modèles OpenAI : migration des paramètres et restrictions
- Lien :
platform.openai.com/docs/guides/latest-model -
À consulter pour les règles concernant des paramètres comme reasoning.effort et max_completion_tokens
-
Page des tarifs OpenAI : tarification par paliers et tarifs du cache
- Lien :
platform.openai.com/docs/pricing - À consulter pour les deux paliers à 272K et la tarification selon la durée d’écriture dans le cache
Auteur : équipe technique d’APIYI
Échanges techniques : contactez-nous depuis la page d’accueil du site APIYI. Pour en savoir plus sur l’intégration, consultez le centre de documentation sur docs.apiyi.com.
