GPT-6.1 Terra API: Python ve JavaScript kodu, Flex maliyeti

👁 114 okunma

GPT-6.1 Terra, OpenAI API’de gpt-6.1-terra, OpenRouter’da ise openai/gpt-6.1-terra adıyla kullanılabiliyor. Aşağıda 26 Ekim 2026’da çalıştırdığım Python ve JavaScript örneklerini bulabilirsiniz: faturadan sabit şemalı JSON’a veri çıkarma ve e-posta için kısa metin oluşturma. Ayrıca OpenRouter üzerinden OpenAI’ın üç modunu ölçtüm. Bir faturayı okumanın maliyeti standart modda 0,00097 USD, daha hızlı çıkan Flex modunda 0,00049 USD oldu. Testin Lehçe yapıldığını özellikle belirteyim; Türkçe performansı ölçmedim.

Terra API’de neler yapabiliyor?

Bilgiler, OpenAI model dokümantasyonundan 26.10.2026 tarihinde kontrol edildi. Responses API’de kullanılabilen araçlar arasında web_search, file_search, code_interpreter, computer_use, mcp ve apply_patch bulunuyor. API’yi ilk kez kullanacaksanız anahtar ve ödeme adımlarını OpenAI API: anahtar, fiyatlar ve ilk istek yazımda anlattım.

Python ile faturadan JSON oluşturma

OpenAI, fatura okumayı Terra’nın kullanım alanlarından biri olarak gösteriyor; ben de testime buradan başladım. Girdi, bir matbaa tarafından kliniğe kesilmiş faturanın Lehçe metniydi: fatura numarası, tarihler, tireli vergi numaraları, üç kalem ve tutarlar. Çıktının JSON şemasına uyması gerekiyor. "strict": True ayarı modelin alan eklemesini veya atlamasını engelliyor. Tüm testlerimde kullandığım OpenRouter üzerinden ve requests kütüphanesiyle çalıştırdım:

import os, json, requests

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

sema = {
  "type": "object",
  "properties": {
    "numara": {"type": "string"},
    "tarih": {"type": "string"},
    "satici_vergi_no": {"type": "string"},
    "kalemler": {"type": "array",
      "items": {
      "type": "object",
      "properties": {
        "ad": {"type": "string"},
        "net": {"type": "number"}},
      "required": ["ad", "net"],
      "additionalProperties": False}},
    "brut": {"type": "number"},
    "son_odeme": {"type": "string"}},
  "required": ["numara", "tarih",
    "satici_vergi_no", "kalemler",
    "brut", "son_odeme"],
  "additionalProperties": False}

def fatura(metin, mod="openai"):
    govde = {
      "model": "openai/gpt-6.1-terra",
      "messages": [
        {"role": "system", "content":
         "Faturalardan veri çıkar. Tarihleri"
         " YYYY-AA-GG biçiminde, vergi"
         " numaralarını tiresiz yaz."},
        {"role": "user",
         "content": metin}],
      "reasoning": {"effort": "low"},
      "response_format": {
        "type": "json_schema",
        "json_schema": {"name": "fatura",
          "strict": True,
          "schema": sema}},
      "provider": {"only": [mod]},
      "usage": {"include": True}}
    r = requests.post(URL, json=govde,
        timeout=120, headers={
        "Authorization": f"Bearer {KEY}"})
    r.raise_for_status()
    j = r.json()
    msg = j["choices"][0]["message"]
    veri = json.loads(msg["content"])
    return veri, j["usage"]

Orijinal test girdisinden bir bölümün çevirisi: “Satıcı: Pracownia Druku Lipa sp. z o.o. (…) Vergi numarası 946-27-18-305”, “Düzenlenme tarihi: 26.10.2026”, “Son ödeme tarihi: 09.11.2026”. Aşağıdaki örnek, Lehçe yapılan testte Terra’nın verdiği yanıtın iki kalemi çıkarılmış hâlinin Türkçe çevirisidir; çevrilmiş metin yeniden test edilmedi:

{
 "numara": "FV/10/2026/118",
 "tarih": "2026-10-26",
 "satici_vergi_no": "9462718305",
 "kalemler": [
  {"ad": "A5 broşür, 170 g",
   "net": 950.0}, ...],
 "brut": 1923.72,
 "son_odeme": "2026-11-09"
}

Model tarihleri ISO biçimine çevirdi, vergi numarasındaki tireleri kaldırdı ve brüt tutarı Lehçe orijinal metnin çevirisiyle “ödenecek tutar 1923,72 orijinal Polonya para birimi” satırından aldı. Orijinal testte bu tutarı 489,6 USD olarak ifade etmek mümkün; bu dönüşüm, makaledeki 26.10.2026 tarihli USD/orijinal Polonya para birimi kuruna dayanıyor. Kullanım: 384 giriş token’ı, 120 çıkış token’ı ve 0,000984 USD. Bu ölçüme göre 1.000 fatura yaklaşık 0,98 USD tutar.

Kopyalamaya değer üç ayar:

• "reasoning": {"effort": "low"} - Alan çıkarmak için low yeterli. Medium daha fazla akıl yürütme token’ı kullanır ve bunlar çıkış token’ı gibi ücretlendirilir. Düzey karşılaştırmasını GPT-6.1 Terra: low, medium yoksa max mı? yazımda anlattım.
• "provider": {"only": ["openai"]} - Bu ayar olmazsa OpenRouter isteği başka bir uç noktaya yönlendirebilir. Burada mod seçebilirsiniz: openai, openai/flex veya openai/fast.
• "usage": {"include": True} - Yanıtta maliyeti USD cinsinden alırsınız; ayrıca hesaplamanız gerekmez.

Standart, Flex ve Fast: test sonuçları

OpenRouter’da Terra için OpenAI’ın üç uç noktası var. Aynı faturayı her birine art arda 5 kez, 26.10.2026 tarihinde yaklaşık 21.45’te gönderdim:

15 yanıtın tamamında vergi numarası ve brüt tutar doğruydu. Flex en hızlı mod çıktı; ancak bu, 26 Ekim akşamı yapılan 5 çağrının sonucu, genel bir kural değil. Yük farklı olduğunda sıralama değişebilir. Fast, standart modun iki katı fiyatına rağmen ölçümümde Flex’ten hızlı değildi. Arka planda işleme için Flex’i veya aynı fiyatlı Batch’i, canlı yanıtlar için standart modu seçerdim.

JavaScript ile e-posta metni oluşturma

Bu örnekte aynı modeli Node.js ile kullanıyorum. 18 veya üzeri sürümlerde fetch yerleşik olarak geliyor. Bu kez Flex ve medium akıl yürütme düzeyini seçtim:

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:
      "Fatura FV/10/2026/118 için " +
      "ödeme hatırlatması içeren 3 e-posta " +
      "konusu yaz. Tutar 489,6 USD." +
      " Ünlem işareti kullanma." }]
  })});
const j = await r.json();
const msg = j.choices[0].message;
console.log(msg.content);

Orijinal test Lehçe yapıldı. Aşağıdaki çıktı, o yanıttaki e-posta konularının Türkçe çevirisidir; Türkçe metin yeniden test edilmedi:

1. FV/10/2026/118 numaralı fatura için
   ödeme hatırlatması
2. FV/10/2026/118 numaralı fatura
   için ödeme talebi
3. FV/10/2026/118 numaralı faturanın
   489,6 USD tutarındaki ödemesi

47 giriş token’ı, 77 çıkış token’ı ve 0,000216 USD. Yanıtta ünlem işareti yok; her konuda fatura numarası ve tutar yer alıyor.

Fatura maliyetini hesaplarken nelere dikkat etmeli?

• 272 bin token eşiği. Tek bir istekte 272 binden fazla giriş token’ı varsa tamamı giriş için 2 USD, çıkış için 7,50 USD üzerinden hesaplanıyor. Uzun belgeleri bölmek daha iyi olabilir.
• Önbellek. İsteğin tekrarlanan başlangıç kısmı (örneğin aynı şema ve talimat) milyon token başına 1 USD yerine 0,05 USD tutuyor.
• Bölgesel işleme (verilerin seçilen bölgede tutulması) fiyatı %10 artırıyor.

Terra’nın fiyatları için GPT-6.1 Terra fiyatı, modelin Lehçe görevlerdeki sonuçları için GPT-6.1 Terra rehberime göz atabilirsiniz.

Sık sorulan sorular

GPT-6.1 Terra’nın API model adı nedir?

OpenAI API’de gpt-6.1-terra, OpenRouter’da openai/gpt-6.1-terra. OpenRouter’daki tarihli sürümün adı openai/gpt-6.1-terra-20261026.

Terra, Chat Completions’ta çalışıyor mu?

Evet. Responses ve Batch de destekleniyor. Bilgisayar kullanımı ve web araması dahil araçlar için Responses API gerekiyor.

Terra ile bir fatura okumanın maliyeti ne kadar?

Ölçümümde, yaklaşık 380 giriş ve 120 çıkış token’ı, low akıl yürütme düzeyiyle standart modda 0,000972 USD, Flex’te 0,000492 USD oldu. Test Lehçe yapıldı; Türkçe kullanım için ölçüm değildir.

Kaynaklar ve kontrol tarihi

• OpenAI API: GPT-6.1 Terra modeli - uç noktalar, araçlar, bağlam, limitler ve fiyatlar (26.10.2026 tarihinde kontrol edildi)
• OpenAI: GPT-6.1 Terra’nın tanıtımı - fatura okuma kullanım alanı (26.10.2026 tarihinde kontrol edildi)
• OpenRouter: GPT-6.1 Terra uç noktaları - openai, openai/flex ve openai/fast modları ve fiyatları (26.10.2026 tarihinde kontrol edildi)
• Ölçümüm: Python 3.13 + requests, Node.js 26, OpenRouter, 26.10.2026, yaklaşık 21.40-21.50

// okumaya devamRaven tek fotoğrafla evinizi bulabilir mi? Maliyeti 3 sentYapay zekânın durumuRestoranlarda AI telefon asistanı maliyeti: İnsan mı, bot mu?DergiCharacter.ai neden battı? Kullanıcı başına maliyet hesabıDergi