GPT-6.1 Terra API : code Python et JavaScript, prix et tests

👁 114 lectures

GPT-6.1 Terra est disponible dans l’API OpenAI sous le nom gpt-6.1-terra et sur OpenRouter sous openai/gpt-6.1-terra. Voici du code Python et JavaScript que j’ai exécuté le 26 octobre 2026 : extraction des données d’une facture vers un JSON à schéma fixe, puis rédaction d’un court texte pour un e-mail. J’ai également mesuré trois modes OpenAI sur OpenRouter. La lecture d’une facture a coûté environ 0,00087 EUR (0,00097 USD) en mode standard et environ 0,00044 EUR (0,00049 USD) en mode Flex, qui s’est aussi révélé plus rapide lors de ma mesure.

Que peut faire Terra dans l’API ?

Données de la page du modèle dans la documentation OpenAI, consultée le 26 octobre 2026. Les outils disponibles dans l’API Responses comprennent notamment web_search, file_search, code_interpreter, computer_use, mcp et apply_patch. Si vous créez un compte API pour la première fois, j’explique la clé et le paiement dans API OpenAI : clé, tarifs et première requête.

Python : extraire une facture en JSON

OpenAI cite la lecture de factures parmi les usages de Terra : c’est par là que j’ai commencé. L’entrée est le texte d’une facture d’imprimerie destinée à une clinique, avec un numéro, des dates, un numéro d’identification fiscale, trois postes et des montants. La sortie doit respecter le schéma JSON : avec "strict": True, le modèle ne peut ni ajouter ni omettre de champ. J’utilise la bibliothèque requests et OpenRouter, le service par lequel j’effectue tous mes tests. Le test original a été réalisé en polonais ; les textes ci-dessous sont des traductions de ce matériel de test, et non un nouveau test en français :

import os, json, requests

URL = ("https://openrouter.ai/api/v1"
       "/chat/completions")
KEY = os.environ["OPENROUTER_API_KEY"]

schema = {
  "type": "object",
  "properties": {
    "numero": {"type": "string"},
    "date": {"type": "string"},
    "identifiant_vendeur": {"type": "string"},
    "articles": {"type": "array",
      "items": {
      "type": "object",
      "properties": {
        "nom": {"type": "string"},
        "montant_ht": {"type": "number"}},
      "required": ["nom", "montant_ht"],
      "additionalProperties": False}},
    "total_ttc": {"type": "number"},
    "echeance": {"type": "string"}},
  "required": ["numero", "date",
    "identifiant_vendeur", "articles",
    "total_ttc", "echeance"],
  "additionalProperties": False}

def facture(texte, mode="openai"):
    body = {
      "model": "openai/gpt-6.1-terra",
      "messages": [
        {"role": "system", "content":
         "Vous extrayez les données des factures."
         " Dates au format AAAA-MM-JJ ;"
         " identifiant sans tirets."},
        {"role": "user",
         "content": texte}],
      "reasoning": {"effort": "low"},
      "response_format": {
        "type": "json_schema",
        "json_schema": {"name": "facture",
          "strict": True,
          "schema": schema}},
      "provider": {"only": [mode]},
      "usage": {"include": True}}
    r = requests.post(URL, json=body,
        timeout=120, headers={
        "Authorization": f"Bearer {KEY}"})
    r.raise_for_status()
    j = r.json()
    msg = j["choices"][0]["message"]
    donnees = json.loads(msg["content"])
    return donnees, j["usage"]

Extrait de la facture d’origine, traduit du polonais : « Vendeur : imprimerie Lipa SARL (…) identifiant fiscal 946-27-18-305 », « Date d’émission : 26 octobre 2026 », « Date limite de paiement : 9 novembre 2026 ». Voici une traduction de la réponse de Terra, abrégée de deux postes :

{
 "numero": "FV/10/2026/118",
 "date": "2026-10-26",
 "identifiant_vendeur": "9462718305",
 "articles": [
  {"nom": "Flyers A5, 170 g",
   "montant_ht": 950.0}, ...],
 "total_ttc": 1923.72,
 "echeance": "2026-11-09"
}

Le modèle a converti les dates au format ISO, supprimé les tirets de l’identifiant fiscal, repris le total TTC dans la ligne « à payer : 489,57 USD » et remplacé la virgule décimale par un point. Consommation : 384 jetons en entrée, 120 en sortie, environ 0,000881 EUR (0,000984 USD). Pour 1 000 factures de ce type, comptez environ environ 0,88 EUR (0,98 USD). Les montants convertis sont des estimations, pas des prix de paiement locaux. Conversion des prix USD en euros au taux de référence de la BCE du 30 octobre 2026 : 1 EUR = 1,1172 USD. Source : https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml.

Trois paramètres à reprendre :

• "reasoning": {"effort": "low"} : le niveau low suffit pour extraire des champs. Medium consommerait davantage de jetons de raisonnement, facturés au tarif de sortie. Je compare les niveaux dans le test GPT-6.1 Terra : low, medium ou max.
• "provider": {"only": ["openai"]} : sans ce paramètre, OpenRouter peut basculer la requête vers un autre point de terminaison. Ici, vous choisissez le mode : openai, openai/flex ou openai/fast.
• "usage": {"include": True} : la réponse inclut le coût en dollars, inutile de le calculer vous-même.

Standard, Flex ou Fast : les résultats de la mesure

Sur OpenRouter, Terra dispose de trois points de terminaison OpenAI. J’ai envoyé cinq fois la même facture à chacun, l’une après l’autre, le 26 octobre 2026 vers 21 h 45. Le test original et les prompts ont été réalisés en polonais :

Les 15 réponses avaient un identifiant fiscal et un total TTC corrects. Flex a été le plus rapide, mais il s’agit de cinq appels effectués dans la soirée du 26 octobre, pas d’une règle : l’ordre peut changer selon la charge. Fast coûte deux fois plus cher que le mode standard et n’a pas été plus rapide que Flex dans ma mesure. Pour le traitement en arrière-plan, je choisirais Flex ou Batch (même tarif : 0,4476 EUR (0,5 USD) / 2,238 EUR (2,5 USD)) ; pour les réponses en direct, le mode standard.

JavaScript : rédiger un texte pour un e-mail

Voici le même modèle avec Node.js (la version 18 ou ultérieure inclut fetch), cette fois en mode Flex et avec un niveau de raisonnement medium. Le prompt d’origine a été testé en polonais ; le texte ci-dessous en est une traduction, pas un nouveau test en français :

const URL = "https://openrouter.ai" +
  "/api/v1/chat/completions";
const KEY =
  process.env.OPENROUTER_API_KEY;
const r = await fetch(URL, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json"},
  body: JSON.stringify({
    model: "openai/gpt-6.1-terra",
    reasoning: { effort: "medium" },
    provider: { only: ["openai/flex"] },
    usage: { include: true },
    messages: [{ role: "user", content:
      "Rédige 3 objets d’e-mail pour " +
      "rappeler le paiement de la facture " +
      "FV/10/2026/118, d’un montant de " +
      "489,57 USD. Sans point d’exclamation." }]
  })});
const j = await r.json();
const msg = j.choices[0].message;
console.log(msg.content);

Traduction de la réponse de Terra au test polonais :

1. Rappel concernant la facture FV/10/2026/118
   d’un montant de 489,57 USD
2. Demande de règlement de la facture
   FV/10/2026/118
3. Paiement de 489,57 USD - facture
   FV/10/2026/118

47 jetons en entrée, 77 en sortie, environ 0,000193 EUR (0,000216 USD). Pas de point d’exclamation ; le numéro de facture et le montant figurent dans chaque objet.

À surveiller dans le calcul du coût

• Seuil de 272 000 jetons. Si une requête dépasse ce nombre de jetons en entrée, l’ensemble est facturé 1,7904 EUR (2 USD) pour l’entrée et 6,714 EUR (7,50 USD) pour la sortie. Mieux vaut diviser les documents longs.
• Cache. La répétition du début d’une requête (par exemple le même schéma et la même instruction) coûte 0,0448 EUR (0,05 USD) par million de jetons au lieu de 0,8951 EUR (1 USD).
• Traitement régional (données dans une région choisie) : supplément de 10 %.

Les tarifs de GPT-6.1 Terra sont détaillés dans GPT-6.1 Terra : tarifs, et les résultats des tests de Terra sur des tâches en polonais dans le guide GPT-6.1 Terra. Ces résultats en polonais ne constituent pas un benchmark en français.

Questions fréquentes

Quel est le nom de GPT-6.1 Terra dans l’API ?

gpt-6.1-terra dans l’API OpenAI et openai/gpt-6.1-terra sur OpenRouter. La version datée sur OpenRouter est openai/gpt-6.1-terra-20261026.

Terra fonctionne-t-il avec Chat Completions ?

Oui, ainsi qu’avec Responses et Batch. Les outils, notamment l’utilisation de l’ordinateur et la recherche sur le Web, nécessitent l’API Responses.

Combien coûte la lecture d’une facture par Terra ?

Dans ma mesure, environ 0,000870 EUR (0,000972 USD) en mode standard et environ 0,000440 EUR (0,000492 USD) en mode Flex, avec environ 380 jetons en entrée et 120 en sortie, au niveau de raisonnement low. Le test a été effectué en polonais.

Sources et date de vérification

• API OpenAI : modèle GPT-6.1 Terra - points de terminaison, outils, contexte, limites et tarifs (consulté le 26 octobre 2026)
• OpenAI : présentation de GPT-6.1 Terra - lecture de factures parmi les usages (consulté le 26 octobre 2026)
• OpenRouter : points de terminaison de GPT-6.1 Terra - modes openai, openai/flex et openai/fast, avec leurs tarifs (consulté le 26 octobre 2026)
• Ma mesure : Python 3.13 + requests, Node.js 26, OpenRouter, 26 octobre 2026, vers 21 h 40-21 h 50

// lire la suiteMuse Wonder : prix de l’API et coût réel des testsOutils d'IASeedance 2.5 : 8 exemples de prompts et tests vidéo en pratiqueOutils d'IAQuelle IA pour coder en Python ? Claude, Copilot ou CursorOutils d'IA