GPT-6.1 Terra API Nasıl Kullanılır?

GPT-6.1 Terra, 26 Ekim 2026'dan itibaren OpenAI API'sinde gpt-6.1-terra olarak kullanılabilir. Responses API, Chat Completions ve Batch üzerinde çalışır, milyon girdi tokenı başına 1 $ ve milyon çıktı tokenı başına 5 $ maliyeti vardır ve 922.000 girdi tokenı ile 128.000 çıktı tokenına kadar kabul eder. Zaten GPT-5.6 Terra'yı çağırıyorsanız, geçiş çoğunlukla tek satırlık bir model değişikliğidir, ancak önce kontrol edilmesi gereken birkaç ayar vardır.

Bu kılavuz, anahtar alma, curl, Python ve Node'da ilk isteğiniz, altı akıl yürütme çabası seviyesi, bilgisayar kullanımı ve diğer araçlar, maliyet kontrolleri ve gpt-5.6-terra'dan geçiş yaparken neleri test etmeniz gerektiğini kapsar. Model genel bakışı için GPT-6.1 Terra nedir sayfasına bakın.

API neleri destekler

Kaynak: OpenAI'nin GPT-6.1 Terra model sayfası. Barındırılan araçlar Responses API'sini gerektirir, bu nedenle yeni işler için onu kullanın.

Adım 1: API anahtarı alın

OpenAI platformu kontrol panelinde bir anahtar oluşturun ve faturalandırma ekleyin. Terra için ücretsiz katman yoktur: bir ChatGPT Plus veya Pro planı size ChatGPT Work ve Codex içinde Terra verir, ancak API anahtarı vermez. GPT-6.1 Terra ücretsiz mi rehberimiz farkı açıklar.

Örneklerin aşağıda okuyabilmesi için dışa aktarın:

export OPENAI_API_KEY="sk-..."

Hız sınırları kullanım katmanınıza bağlıdır. Model sayfası Build katmanında dakikada 5.000 istek ve 1 milyon token, Launch'ta 10.000 ve 4 milyon, Grow'da 15.000 ve 40 milyon listeler.

Adım 2: ilk isteğinizi gönderin

curl ile, Responses API'sine karşı:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "reasoning": { "effort": "low" },
    "input": "Summarize the difference between PUT and PATCH in two sentences."
  }'

Resmi SDK ile Python'da:

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="Summarize the difference between PUT and PATCH in two sentences.",
)

print(response.output_text)
print(response.usage)

Node'da:

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6.1-terra",
  reasoning: { effort: "low" },
  input: "Summarize the difference between PUT and PATCH in two sentences.",
});

console.log(response.output_text);
console.log(response.usage);

Başlangıçtan itibaren usage yazdırın. Size girdi, önbelleğe alınmış ve çıktı tokenlarını söyler ve akıl yürütme tokenları çıktı olarak faturalandırılır.

Adım 3: bir akıl yürütme çabası seçin

Terra altı çaba seviyesini destekler. Varsayılan medium'dır.

İki nokta öne çıkıyor.

none destekleniyor. GPT-6.1 Sol bunu kaldırdı, bu yüzden bu ikisi arasındaki pratik farklardan biri. OpenAI'nin topluluk forumundaki bir geliştirici, reasoning.effort: "none" ile Terra'nın temperature ve top_p'yi tekrar kabul ettiğini bildiriyor. Verileri toplu olarak etiketleyen veya çıkaran bir işlem hattı için none, çağrı başına en düşük maliyeti ve tekrarlanabilir çıktıyı sağlar.

En çok düşük çaba gelişti. OpenAI'nin dahili gerçeklik testinde, Terra'nın düşük çabadaki hata oranı GPT-5.6 Terra'daki %53,6'dan %16,7'ye düştü. Artificial Analysis ayrıca GPT-5.6 Terra'ya kıyasla daha düşük çaba seviyelerinde (7 ila 13 puan) max'a (6 puan) göre daha büyük kazanımlar ölçtü. Kabul edilebilir kalite elde etmek için GPT-5.6 Terra'yı high'da çalıştırdıysanız, aynı ayara ihtiyacınız olduğunu varsaymadan önce 6.1 Terra'da low veya medium'ı deneyin.

Adım 4: bilgisayar kullanımı dahil araçları kullanın

OpenAI bu sürümü “daha düşük fiyata hızlı ve yetenekli bilgisayar kullanımı” etrafında tanıttı. Bilgisayar kullanımı, web arama, dosya arama ve diğer barındırılan araçlar Responses API'sinde mevcuttur. Bir web arama çağrısı şöyle görünür:

response = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    tools=[{"type": "web_search"}],
    input="What changed in the latest OpenAPI Specification release?",
)
print(response.output_text)

Fonksiyon çağrısı ve yapılandırılmış çıktılar diğer GPT-6 modellerinde olduğu gibi çalışır: fonksiyon şemalarınızı tools içinde tanımlayın veya metin formatı ayarında bir JSON şeması iletin ve geri geleni doğrulayın. Gerçek bir uygulamaya karşı bilgisayar kullanımına daha derin bir bakış için, GPT-6 Astra bilgisayar kullanımı kılavuzumuz Terra için de geçerlidir, Astra'nın token başına fiyatının onda birine.

Adım 5: maliyeti kontrol edin

Terra'nın ücretleri zaten düşük ve dört ayar bunları daha da düşürür:

• İstem önbelleğe alma otomatiktir. Önbelleğe alınmış girdi, milyon başına yeni girdi için 1 $'a karşılık 0,05 $'a mal olur. Kararlı içeriği (sistem istemi, araç şemaları, referans belgeleri) istemin önünde tutun. Önbellek yazmaları, 30 dakikalık saklama için milyon başına 1,25 $ veya 12 saat için 2,50 $'a mal olur. GPT-6 istem önbelleğe alma kılavuzumuza bakın.
• Batch, eşzamansız işler için her ücreti yarıya indirir: 0,50 $ girdi, 2,50 $ çıktı. OpenAI Batch API kılavuzumuz tüm akışı gösterir.
• Flex, normal isteklerde service_tier: "flex" ile aynı yarı ücreti verir, karşılığında daha yavaş yanıtlar ve ara sıra 429'lar alırsınız.
• 272K sınırı. 272K girdi tokenının üzerindeki istemler, tüm isteği 2x girdi ve önbellek ücretleri ile 1.5x çıktı üzerinden faturalandırır. Sınıra yakınsanız, aşmak yerine getirilen bağlamı kısaltın.

Hızlı mod tam tersi yönde çalışır: daha hızlı yanıtlar için Standart ücretin 2 katı (2 $ girdi, 10 $ çıktı). GPT-6.1 Terra fiyatlandırma kılavuzu tüm ücretleri tek bir tabloda içerir.

gpt-5.6-terra'dan geçiş

Model kimliği değişikliği tek satırdır. Etrafında kontrol edilecek şeyler şunlardır:

1. Fiyat. Girdi 2 $'dan 1 $'a, önbelleğe alınmış girdi 0,20 $'dan 0,05 $'a, çıktı 12 $'dan 5 $'a düşer. Ücretleri sabit kodlayan maliyet panolarını veya bütçe uyarılarını güncelleyin.
2. Çaba ayarı. Daha düşük bir çabada yeniden test edin. low'daki kalite en çok değişti.
3. Bilgi kesim tarihi. Terra'nınki 1 Haziran 2026'dır. Daha eski bir kesim tarihini varsayan istemler veya tarihe duyarlı beklenen yanıtları olan testler değişebilir.
4. Çıktı uzunluğu ve formatı. Yeni bir model daha uzun veya daha kısa yanıtlar yazabilir. usage.output_tokens'ı ve sabit bir format bekleyen tüm ayrıştırıcıları kontrol edin; şeklin önemli olduğu yerlerde yapılandırılmış çıktıları kullanın.
5. Hız. OpenAI, Terra'nın görevleri Astra ve GPT-6.1 Sol'dan ortalama 3 kattan fazla daha hızlı bitirdiğini söylüyor. Daha yavaş modeller için ayarlanmış zaman aşımları sorun değil, ancak uzun beklemeler etrafında oluşturulmuş yeniden deneme ve yoklama mantığı artık israf olabilir.
6. Codex. Ekibiniz Codex kullanıyorsa, Terra için Codex CLI 0.159.0 veya üstü gerekir: codex -m gpt-6.1-terra.

OpenAI, GPT-5.6 Terra için bir kullanımdan kaldırma tarihi açıklamadı, bu nedenle karşılaştırırken ikisini yan yana çalıştırabilirsiniz.

Kodlama ajanınızın geçişi Apidog CLI ile kanıtlamasına izin verin

Adım 1'den 6'ya kadar olan kontroller tam olarak elle yapmamanız gereken türdendir. Kodlama ajanınızı Apidog CLI'a yönlendirin; testi oluşturabilir, her iki modelde çalıştırabilir ve size neyin değiştiğini söyleyebilir.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Ardından Claude Code, Codex veya Cursor'a bir istem verin:

In Apidog project <id>, add POST https://api.openai.com/v1/responses as an endpoint.
Create a test case that sends my production prompt with model {{MODEL}} and reasoning
effort low, and asserts: status 200, output_text not empty, output matches our JSON
schema, usage.output_tokens under 3000. Run it with MODEL=gpt-5.6-terra and again with
MODEL=gpt-6.1-terra against the <env> environment, then compare tokens and failures.

Ajan her şemayı okur, yükünü doğrular ve vakayı iki kez çalıştırır:

apidog cli-schema get endpoint-create
apidog endpoint create --project <id> --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "MODEL=gpt-5.6-terra" -r cli,json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "MODEL=gpt-6.1-terra" -r cli,json

OpenAI anahtarınızı Apidog ortamında saklayın. Terra çalışması geçtiğinde, -r junit ile CI'ye ekleyin, böylece daha sonraki bir istem veya model değişikliği sözleşmeyi sessizce bozamaz; Apidog CLI CI/CD kılavuzumuz ardışık düzen dosyasını içerir ve Codex'te Apidog CLI Codex kurulumunu kapsar.

SSS

GPT-6.1 Terra model kimliği nedir? gpt-6.1-terra. Tek bir snapshot vardır ve aynı zamanda varsayılandır.

GPT-6.1 Terra, Chat Completions ile çalışır mı? Evet. Responses, Chat Completions ve Batch'i destekler. Web arama ve bilgisayar kullanımı gibi barındırılan araçlar Responses API'sini gerektirir.

GPT-6.1 Terra'da temperature ayarlayabilir miyim? Bir topluluk raporu, reasoning.effort: "none" ile evet diyor. Diğer çaba seviyelerinde, örnekleme ayarlarını göndermeden önce model sayfasını kontrol edin.

GPT-6.1 Terra, Realtime API'yi destekliyor mu? Hayır. Realtime, Live, Assistants ve ince ayar desteklenmez.

GPT-6.1 Terra hız sınırı nedir? Katmanınıza bağlıdır: Build'de dakikada 5.000 istek ve 1 milyon token'dan Grow'da 15.000 ve 40 milyona kadar.

Sonraki adım

Bir uç noktada model kimliğini değiştirin, daha düşük bir çabada yeniden test edin ve ajanınızın Apidog CLI ile iki çalışmayı karşılaştırmasına izin verin. Sayılar tutarsa, kullanıma sunun. Terra'nın mı yoksa Sol'un mu iş yükünüze uyduğundan emin değil misiniz? GPT-6.1 Terra vs GPT-6.1 Sol yazısını okuyun.