DEV Community

Cover image for GPT-6.2 Astra API Nasıl Kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

GPT-6.2 Astra API Nasıl Kullanılır?

GPT-6.2 Astra API Rehberi: İlk İstek, Effort Ayarı, Fiyatlandırma ve Otomatik Test

Hızlı yanıt: GPT-6.2 Astra API'sini kullanmak için OpenAI'nin Responses uç noktasına (POST /v1/responses) "model": "gpt-6.2-astra", "high" gibi bir akıl yürütme çabası (reasoning effort) ve girdinizle birlikte bir istek gönderin. Milyon giriş tokenı başına 8 dolar, milyon çıkış tokenı başına 40 dolar maliyeti vardır; 922K'ya kadar giriş tokenı alır ve 128K'ya kadar döndürür. Effort değerini none yapmayın: API bunu reddeder.

Apidog'u bugün deneyin

OpenAI, GPT-6.2 Astra ile daha ucuz kardeşi GPT-6.2 Sol'u 17 Kasım 2026'da yayımladı. Daha önce GPT-6 Astra'yı çağırdıysanız, kodunuzun çoğu olduğu gibi çalışır. Bu rehber, ilk isteğinizden araç çağrılarına, effort ayarına, fiyatlandırma tuzaklarına ve kodlama ajanınızın sizin adınıza çalıştırabileceği tekrarlanabilir bir teste kadar GPT-6.2 Astra API'sini adım adım ele alıyor.

İlk GPT-6.2 Astra API çağrınızdan önce neye ihtiyacınız var

Dört şeye ihtiyacınız var ve muhtemelen üçüne zaten sahipsiniz:

  1. Platform panosundan alınmış ve OPENAI_API_KEY olarak dışa aktarılmış bir OpenAI API anahtarı.
  2. Ücretli bir kullanım katmanı. OpenAI'nin model sayfası, Astra hız limitlerini Build katmanından (dakikada 5.000 istek ve 1M token) itibaren listeliyor.
  3. Model kimliği: gpt-6.2-astra. Daha ucuz model gpt-6.2-sol.
  4. Desteklenen bir uç nokta: Responses, Chat Completions veya Batch. Realtime, Assistants ve fine-tuning iki modeli de desteklemiyor.

Bu özellikler, 18 Kasım 2026 tarihinde kontrol edilmiş OpenAI'nin GPT-6.2 Astra model sayfasından alınmıştır.

Özellik GPT-6.2 Astra
Model kimliği gpt-6.2-astra
Bağlam penceresi 1.050.000 token
Azami giriş 922.000 token
Azami çıkış 128.000 token
Bilgi kesim tarihi 18 Mayıs 2026
Uç noktalar Responses, Chat Completions, Batch
Özellikler Streaming, function calling, yapılandırılmış çıktılar, görüntü girişi, prompt önbellekleme

İlk GPT-6.2 Astra API isteğinizi nasıl yaparsınız

Responses API, OpenAI'nin yeni özellikler geliştirdiği uç noktadır; o yüzden buradan başlayın. Adımlar şöyle:

  1. Anahtarınızı dışa aktarın: export OPENAI_API_KEY=sk-...
  2. Model kimliği ve bir effort düzeyiyle istek gönderin.
  3. Yanıt için output_text, token sayısı için usage alanını okuyun.

curl ile:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.2-astra",
    "reasoning": { "effort": "high" },
    "input": "Review this migration plan and list the three biggest risks."
  }'
Enter fullscreen mode Exit fullscreen mode

Resmi Python SDK ile (pip install --upgrade openai):

from openai import OpenAI

client = OpenAI()  # reads OPENAI_API_KEY

response = client.responses.create(
    model="gpt-6.2-astra",
    reasoning={"effort": "high"},
    input="Review this migration plan and list the three biggest risks.",
)

print(response.output_text)
print(response.usage)
Enter fullscreen mode Exit fullscreen mode

Node.js ile (npm install openai):

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6.2-astra",
  reasoning: { effort: "high" },
  input: "Review this migration plan and list the three biggest risks.",
});

console.log(response.output_text);
Enter fullscreen mode Exit fullscreen mode

İlk çağrılarda her seferinde usage bloğunu kontrol edin. Astra tek bir kelime yazmadan önce akıl yürütme tokenları harcar ve bunlar çıkış olarak faturalandırılır. Kısa bir yanıt bile beklediğinizden pahalıya gelebilir.

Diagram of a GPT-6.2 Astra API request

GPT-6.2 Astra için bir akıl yürütme effort düzeyi seçin

Reasoning effort, hem kalite hem de maliyet üzerindeki en büyük koldur. OpenAI'nin akıl yürütme rehberi none, minimal, low, medium, high, xhigh ve max değerlerini listeler ve her modelin yalnızca bir alt kümeyi desteklediğini belirtir. GPT-6.2 Astra ve Sol için doğrulanmış tek kural none değerinin reddedilmesidir; yani her çağrı bir miktar akıl yürütme yapar.

Effort Ne için kullanın
low / medium Basit düzenlemeler, veri çıkarma, kısa yanıtlar
high Kod inceleme, planlama, zor isteklerin çoğu. Teste başlamak için makul bir varsayılan
xhigh Uzun ajan çalıştırmaları ve asenkron işler; yalnızca eval'lar net bir kazanç gösteriyorsa
max En zor problemleriniz; daha iyi bir yanıtın birkaç kat token maliyetini karşıladığı durumlar

OpenAI, Astra'nın varsayılan effort düzeyini belirtmiyor; bu yüzden her istekte açıkça ayarlayın. Bu, faturalarınızın ve test sonuçlarınızın tekrarlanabilir olmasını sağlar.

Effort, faturayı ne kadar değiştiriyor? Simon Willison, lansman gününde aynı görüntü prompt'unu üç effort düzeyinde her modelle çalıştırdı ve maliyetleri yayımladı. Astra high düzeyinde 11,55 cent, xhigh düzeyinde 17,70 cent ve max düzeyinde 88,71 cent tuttu. highdan maxa geçmek maliyeti neredeyse sekiz katına çıkardı.

Bar chart of cost per run

GPT-6.2 Astra'nın high ve xhigh düzeylerinde GPT-6 Astra'dan daha ucuz, ama max düzeyinde daha pahalı olduğunu fark edin. Token başına fiyat %20 düştü, ancak max effort daha uzun düşünüyor. Milyon token başına maliyeti değil, tamamlanan görev başına maliyeti ölçün.

GPT-6.2 Astra API ile araçlar ve yapılandırılmış çıktılar

Astra, Responses API'de function calling, yapılandırılmış çıktılar ve uzun bir barındırılan araçlar listesini destekler: web arama, dosya arama, görüntü üretme, code interpreter, barındırılan shell, apply patch, skills, computer use, MCP ve tool search.

Bir function aracı, GPT-6 Astra'dakiyle aynı görünür:

response = client.responses.create(
    model="gpt-6.2-astra",
    reasoning={"effort": "high"},
    tools=[{
        "type": "function",
        "name": "get_order_status",
        "description": "Look up an order by its ID.",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    }],
    input="Where is order A-1042?",
)

for item in response.output:
    if item.type == "function_call":
        print(item.name, item.arguments)
Enter fullscreen mode Exit fullscreen mode

Fonksiyonu kendiniz çalıştırın, ardından sonucu eşleşen call_id ile bir function_call_output öğesi olarak geri gönderin. Astra nihai yanıtı bundan üretir.

Makine tarafından okunabilir çıktı için text.format alanında "type": "json_schema" ve "strict": true ile bir JSON şeması geçirin. Model, şemanızla eşleşen JSON döndürür; böylece tahmin yapmadan ayrıştırabilirsiniz.

Bu kadar yetenekli bir modelle iki alışkanlık işe yarar. Birincisi, her araca kısa ve net bir açıklama ve katı bir şema verin; lansman günündeki incelemeciler, Astra'nın uzun ve açık uçlu görevlerde savrulabildiğini bildirdi. İkincisi, ajan döngülerinde max_output_tokens ayarlayın ki tek bir kontrolden çıkan adım bütçenizi tüketemesin. Uç noktanın kendisi hakkında bilgi için OpenAI Responses API rehberimize bakın.

GPT-6.2 Astra API fiyatlandırması ve hız limitleri

Astra, milyon token başına fiyatlandırılır; çok uzun promptlar için ek ücret uygulanır. Bu fiyatlar model sayfasından alınmıştır:

Kalem GPT-6.2 Astra GPT-6 Astra (referans için)
Giriş 8,00 $ 10,00 $
Önbelleğe alınmış giriş 0,40 $ 1,00 $
Önbellek yazmaları (30 dk saklama) 10,00 $ yok
Çıkış 40,00 $ 50,00 $

Tuzak, uzun bağlam kuralıdır. Bir istek 272K giriş tokenını aştığında, giriş ve önbellek fiyatları iki katına çıkar ve çıkış, isteğin tamamı için 1,5 katına çıkar. 300K tokenlık bir prompt, yalnızca sınırı aşan tokenlar için değil, 16 $ giriş ve 60 $ çıkış olarak faturalanır. Astra'ya bütün depolar besliyorsanız, mümkün olduğunca 272K altında parçalayın veya önbelleğe alın.

Batch işleri, bekleyebilecek eval'lar ve geri doldurma işleri için uygundur; VentureBeat, Batch'in yarı fiyatla çalıştığını bildiriyor.

Katmana göre standart hız limitleri:

Katman İstek/dk Token/dk
Build 5.000 1.000.000
Launch 10.000 4.000.000
Grow 15.000 40.000.000

429 yanıtlarını üstel geri çekilme (exponential backoff) ile yönetin. xhigh düzeyinde uzun bir ajan çalıştırması, Build katmanı token bütçesini hızla tüketebilir.

GPT-6 Astra'dan GPT-6.2 Astra'ya geçiş

Kodların çoğu tek bir değişikliğe ihtiyaç duyar: model adı. Üretimde değiştirmeden önce şunları kontrol edin:

  • Model kimliği: gpt-6-astra yerine gpt-6.2-astra.
  • Effort none: herhangi bir kod yolu bunu gönderiyorsa artık hata verir. Eval'larınızın kabul ettiği en düşük değere geçin.
  • Prompt önbellekleme: önbelleğe alınmış giriş 1,00 $dan 0,40 $a düştü; böylece kararlı sistem promptları ve araç listeleri artık önbelleklenmeye değer.
  • Uzun promptlar: 272K tokena yakın her isteği yukarıdaki uzun bağlam kuralına göre yeniden kontrol edin.
  • Güvenlik: OpenAI, her iki GPT-6.2 modelinin de "Critical" siber güvenlik eşiğine ulaştığını ve daha katı güvenlik önlemleriyle geldiğini söylüyor. Güvenlik araçları promptları, daha önce almadıkları reddalmalar alabilir.

İlk incelemeler karışık, bu yüzden geçmeden önce test edin. Ethan Mollick, Astra'yı "çok tutarsız ve tuhaf" olarak nitelendirdi; Dan Shipper ise uçtan uca yapılarda sık sık erken durduğunu söyledi (VentureBeat'in derlemesinden). Diğerleri kod incelemesini ve computer use özelliğini övdü. Gerçekten önemli olan tek kıyaslama, kendi promptlarınızdır. GPT-6 Astra API rehberi, önceki nesilden taşınanları ele alır; trafiğinizin çoğu rutinse GPT-6.1 Sol API rehberi, daha ucuz katmanın istek yapısını gösterir.

Kodlama ajanınız GPT-6.2 Astra'yı Apidog CLI ile test etsin

Terminal içine prompt yapıştırmak, Astra'nın bugün nasıl performans gösterdiğini söyler. Bir ay sonra bir güncelleme şemanızı bozduğunda size bunu söylemez. Bunun yerine, kontrolü kodlama ajanınıza kurdurun ve Apidog CLI ile çalıştırın; siz tek bir prompt yazarsınız.

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted
Enter fullscreen mode Exit fullscreen mode

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

In Apidog project <projectId>, create a test case for POST https://api.openai.com/v1/responses
with model "gpt-6.2-astra", reasoning effort "high" and a get_order_status function tool.
Assert status 200, that the output contains a function_call named get_order_status,
that its arguments parse as JSON with an order_id, and that usage.output_tokens is under 4000.
Read the API key from the OPENAI_API_KEY variable in environment <envId>, then run it.
Enter fullscreen mode Exit fullscreen mode

Ajan, payload şemasını okur, dosyasını kontrol eder, test senaryosunu oluşturur ve çalıştırır:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

Anahtarı prompt içinde değil Apidog ortamında tutun; böylece asla ajanınızın bağlamına girmez. Çalıştırmayı Apidog uygulamasında incelemek için --upload-report, Astra'nın araç çağrılarının ne kadar tutarlı olduğunu görmek için tekrarlamak amacıyla -n 5 ekleyin. Pipeline'a -r junit ekleyin ve kontrol her dağıtımda yeniden çalışsın; kurulumu Apidog CLI in CI/CD rehberi gösterir, ajan tarafını da Apidog CLI in Claude Code ele alır. Apidog'nin Free planı 4 kullanıcıya kadar ekipleri kapsar.

SSS

GPT-6.2 Astra API model kimliği nedir? gpt-6.2-astra. Daha ucuz kardeşi gpt-6.2-sol. İkisi de Responses, Chat Completions ve Batch uç noktalarında çalışır.

GPT-6.2 Astra API ne kadar tutar? Milyon giriş tokenı başına 8 $, milyon önbelleğe alınmış giriş tokenı başına 0,40 $ ve milyon çıkış tokenı başına 40 $. 272K giriş tokenını aşan istekler, isteğin tamamı için iki kat giriş ve 1,5 kat çıkış ücreti öder.

GPT-6.2 Astra isteğim reasoning effort none ile neden başarısız oluyor? Her iki GPT-6.2 modeli de "effort": "none" değerini reddeder. high ayarlayın ya da testlerinizin göreviniz için işe yaradığını gösterdiği en düşük düzeyi kullanın.

GPT-6.2 Astra bağlam penceresi nedir? Toplam 1.050.000 token; 922.000 giriş tokenı ve 128.000 çıkış tokenına kadar.

GPT-6.2 Astra'yı Chat Completions API ile kullanabilir miyim? Evet. Destekleniyor, ancak web arama, computer use ve apply patch gibi barındırılan araçlar Responses API için listeleniyor; ajan işleri için Responses kullanın.

GPT-6.2 Astra ücretsiz kullanılabilir mi? API'de hayır; her çağrı faturalanır. ChatGPT Work ve Codex'te Plus, Pro, Enterprise ve Edu planlarına dahildir (OpenAI'nin lansman duyurusuna göre).

Top comments (0)