
Bu GPT-6.2 API kılavuzu sizi bir API anahtarından, hem Responses hem Chat Completions uç noktalarında cURL ve Python OpenAI SDK ile gpt-6.2-sol veya gpt-6.2-astra için çalışan bir isteğe götürür. Her istek gövdesi, 18 Kasım 2026 itibarıyla PoYo'nun yayımlanmış şemasına ve OpenAI'ın GPT-6.2 geçiş notlarına uyar. İstemleri önce GPT-6.2 Sol model sayfasında veya GPT-6.2 Astra model sayfasında test edebilirsiniz.
Modellerde yeni misiniz? GPT-6.2 API genel bakışı limitleri ve konumlandırmayı ele alıyor.
Başlamadan önce
PoYo panelinde bir anahtar oluşturun ve sunucunuzda saklayın:
export POYO_API_KEY="your-poyo-key"
| Biçim | Uç nokta | Ne zaman kullanılır |
|---|---|---|
| Responses | POST https://api.poyo.ai/v1/responses | Yeni kod, fonksiyon araçları, görsel girdi, akıl yürütme düzeyi |
| Chat Completions | POST https://api.poyo.ai/v1/chat/completions | Mevcut Chat Completions kodu, yalnızca metin içeren mesajlar, araç yok |
Her istek Authorization: Bearer $POYO_API_KEY gönderir. Örneklerde gpt-6.2-sol kullanılıyor; Astra için bunu gpt-6.2-astra ile değiştirin. İstek yapıları aynıdır.
OpenAI'ın GPT-6.2 kılavuzundaki üç kural aşağıdaki her örnek için geçerlidir:
temperatureveyatop_pgöndermeyin. OpenAI bunların yanı sıra Chat Completions'talogprobsvetop_logprobs, Responses'ta isetop_logprobsalanlarının da çıkarılmasını söylüyor. PoYo'nun şemaları eski modeller içintemperaturevetop_palanlarını hâlâ listeliyor.- Akıl yürütme düzeyini
noneolarak ayarlamayın; API bunu reddeder. - Sabit talimatları
input'un başındaki birdevelopermesajına koyun. GPT-6.2, üst düzeyinstructionsalanınıinput'tan sonra ekler; bu da onları önbelleğe alınabilir önekin dışına taşır.
cURL ile ilk GPT-6.2 API isteği
curl https://api.poyo.ai/v1/responses \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"input": [
{"role": "developer", "content": "You are a code reviewer. Be specific and cite line numbers."},
{"role": "user", "content": "Review this function for race conditions: ..."}
],
"reasoning": {"effort": "medium"},
"max_output_tokens": 8000,
"store": false
}'
model ve input zorunludur. input düz bir string ya da role (developer, system, user, assistant) ve content içeren öğelerden oluşan bir dizidir. Bu kılavuzda kullanılan diğer belgelenmiş alanlar: reasoning, max_output_tokens, stream, store, tools, tool_choice, previous_response_id ve metadata.
Yanıt, doğrudan döndürülen bir Responses nesnesidir. Metin, type: "output_text" olan output[].content[] bloklarında; çağrının durumu status içinde; sayılar ise usage.input_tokens, usage.output_tokens ve usage.total_tokens içinde yer alır.
OpenAI SDK ile Python
SDK'yı PoYo'ya yönlendirin:
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
resp = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Write a migration plan from Celery 4 to Celery 5."},
],
reasoning={"effort": "medium"},
max_output_tokens=8000,
)
print(resp.output_text)
print(resp.status, resp.usage)
resp.output_text, tüm output_text bloklarını birleştiren SDK yardımcısıdır. Her çağrıda resp.usage değerini loglayın; aşağıdaki maliyet bölümü bunu okur.
Mevcut kod için Chat Completions
Kodunuz zaten chat.completions.create kullanıyorsa modeli değiştirin ve örnekleme alanlarını kaldırın:
resp = client.chat.completions.create(
model="gpt-6.2-sol",
messages=[
{"role": "system", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Explain the CAP theorem with one example per trade-off."},
],
max_tokens=4000,
)
print(resp.choices[0].message.content, resp.choices[0].finish_reason)
Aynı istek cURL ile:
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"messages": [{"role": "user", "content": "Explain vector databases in one sentence."}],
"max_tokens": 1000
}'
PoYo'nun Chat Completions şeması model, messages (string content; system, user, assistant rolleri), max_tokens, stream, stop, n ve ceza alanlarını belgeler. tools belgelenmemiştir ve OpenAI, GPT-6.2'de araç çağırmanın Responses gerektirdiğini söyler; bu yüzden ajanların yeri /v1/responses'tur.
GPT-6.2 API ile akıl yürütme düzeyini ayarlama
OpenAI bu alanı Responses'ta reasoning.effort, Chat Completions'ta reasoning_effort olarak adlandırır. PoYo'nun Responses referansı reasoning alanını belgeler (örnek {"effort": "medium"}); Chat Completions referansı ise henüz reasoning_effort alanını listelemiyor. Bu nedenle bu kılavuz düzeyi yalnızca Responses'ta ayarlar.
| Durum | Ayar | Kaynak |
|---|---|---|
| Yeni entegrasyon | medium | OpenAI: "Yeni bir entegrasyon için medium ile başlayın." |
Önceden none veya minimal | low | OpenAI GPT-6.2 geçiş notu |
| Uzun veya karmaşık görevler | Daha yüksek bir düzey | OpenAI: daha yüksek düzey "son kontrollere kadar sebat etmesine yardımcı olabilir" |
none | Reddedilir | OpenAI model sayfaları |
OpenAI'ın akıl yürütme kılavuzu olası değerler arasında low, medium, high, xhigh ve max değerlerini sayar, ancak bunların modele bağlı olduğunu söyler. GPT-6.2 model sayfaları kabul edilen kümeyi listelemiyor; bu yüzden medium üzerindeki bir düzeyi koda sabitlemeden önce bir test isteği gönderin. Akıl yürütme token'ları çıktı olarak faturalandırılır ve max_output_tokens sınırından düşer; OpenAI bunları usage.output_tokens_details.reasoning_tokens içinde raporlar.
GPT-6.2 API yanıtlarını akışla alma
"stream": true ile PoYo text/event-stream döndürür. Her data: satırı, type alanı olayı adlandıran bir JSON'dur; metin response.output_text.delta olarak gelir, response.completed ise usage ile birlikte son nesneyi taşır. PoYo ayrı event: satırları göndermez ve akış data: [DONE] ile biter.
stream = client.responses.create(
model="gpt-6.2-sol",
input="Write a 100-word product introduction for a log search tool.",
reasoning={"effort": "low"},
max_output_tokens=2000,
stream=True,
store=False,
)
usage = None
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
usage = event.response.usage
elif event.type == "response.failed":
raise RuntimeError(event.response)
print("\n", usage)
Chat Completions'ta stream=True, chat.completion.chunk olayları döndürür; metin choices[0].delta.content içindedir ve son parça usage bilgisini taşır.
Görsel girdi
GPT-6.2, metinle birlikte görsel kabul eder. PoYo'da görselleri Responses'a, herkese açık bir URL veya tam bir Data URI (data:image/png;base64,...) içeren input_image blokları olarak gönderin. PoYo belgeleri metni görsellerden önce koymayı öneriyor:
{
"model": "gpt-6.2-sol",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "List every service in this architecture diagram that writes to the database."},
{"type": "input_image", "image_url": "https://example.com/diagram.png"}
]
}
],
"max_output_tokens": 3000
}
Kullanımı okuyun ve isteğin maliyetini hesaplayın
PoYo'da 1M token başına fiyatlar: Sol $1.60 girdi, $8 çıktı, $0.08 önbellek okuma, $2 önbellek yazma; Astra $6.40, $32, $0.32, $8 (1 kredi = $0.005).
OpenAI'ın önbellek kılavuzu, faturalandırılan önbellek okumalarını usage.input_tokens_details.cached_tokens, yazmaları ise usage.input_tokens_details.cache_write_tokens içinde raporlar. PoYo'nun şeması input_tokens_details ve output_tokens_details alanlarını içerir ama anahtarlarını listelemez; bu yüzden bunları savunmacı biçimde okuyun:
PRICES = { # PoYo USD per 1M tokens: input, output, cache read, cache write
"gpt-6.2-sol": (1.60, 8.00, 0.08, 2.00),
"gpt-6.2-astra": (6.40, 32.00, 0.32, 8.00),
}
def estimate_cost_usd(model: str, usage) -> float:
p_in, p_out, p_read, p_write = PRICES[model]
details = getattr(usage, "input_tokens_details", None)
cached = getattr(details, "cached_tokens", 0) or 0
written = getattr(details, "cache_write_tokens", 0) or 0
fresh = usage.input_tokens - cached - written
return (fresh * p_in + cached * p_read + written * p_write
+ usage.output_tokens * p_out) / 1_000_000
Bunu bir tahmin olarak görün ve PoYo kullanım kaydınızla karşılaştırın. Buradaki her fiyat kısa bağlam ücretidir. OpenAI, 272K girdi token'ının üzerinde daha fazla ücret alır; bu boyuttaki her istek için model sayfasını kontrol edin. Hesaplanmış örnekler GPT-6.2 API fiyatlandırması yazısında.
Ele alınması gereken hatalar
| HTTP | Neden | Ne yapılmalı |
|---|---|---|
| 400 | Geçersiz alan (validation_error, ayrıntılar listelenir) | Gövdeyi düzeltin; none düzeyi veya belgelenmemiş bir alan buraya düşebilir |
| 401 | Eksik veya geçersiz API anahtarı | Authorization başlığını kontrol edin |
| 402 | Yetersiz kredi | Yeniden denemeden önce bakiye yükleyin |
| 404 | Bilinmeyen model (model_not_found) | Kimliği kontrol edin: gpt-6.2-sol, gpt-6.2-astra |
| 429 | Hız sınırı | Bekleyip yeniden deneyin |
| 500 / 502 / 503 | Sunucu veya üst kaynak hatası | Üstel geri çekilmeyle yeniden deneyin |
PoYo belgeleri LLM uç noktalarının şu anda hız sınırına tabi olmadığını söylüyor, ama yine de 429'u ele alın. OpenAI SDK ile openai.APIStatusError yakalayın ve status_code değerine göre dallanın. Yalnızca 5xx ve 429 için yeniden deneyin; bir 400, gövde değişene kadar yine başarısız olur. Tam gövdeler PoYo hata kodlarında yer alıyor.
Yayına almadan önce kontrol listesi
POYO_API_KEYanahtarını sunucu tarafında tutun; asla tarayıcı veya mobil koduna koymayın.- Paylaşılan yardımcı fonksiyonlar dahil her GPT-6.2 istek yolundan
temperaturevetop_palanlarını kaldırın. - Her zaman
max_output_tokens(veyamax_tokens) ayarlayın ve bu sınırın içinde akıl yürütme token'larına yer bırakın. - Kesilmiş yanıtlar ve maliyet sıçramaları görünür olsun diye
status/finish_reasonileusagebloğunun tamamını kendi istek kimliğinizin yanında loglayın. - Uzun, sabit bağlamı ilk
developermesajına, değişen soruyu ise en sona koyun; bu, istem önbelleğinin devreye girmesine şans tanır. - Model kimliğini yapılandırmada sabitleyin; böylece deploy yapmadan
gpt-6.2-solilegpt-6.2-astraarasında geçiş yapabilirsiniz.
Araçlar, araç çağrılarının akışı ve uzun ajan oturumlarında önbellek için kodlama ajanları için GPT-6.2 API yazısıyla devam edin.
Sıkça sorulan sorular
GPT-6.2 API'yi Python'da nasıl çağırırım?
OpenAI SDK'yı base_url="https://api.poyo.ai/v1", PoYo anahtarınız ve client.responses.create içinde model="gpt-6.2-sol" veya "gpt-6.2-astra" ile kullanın.
GPT-6.2 API akışı destekliyor mu?
Evet, her iki uç noktada da. stream: true ayarlayın; Responses response.output_text.delta gibi tipli olaylar, Chat Completions ise chat.completion.chunk olayları gönderir. İkisi de data: [DONE] ile biter.
GPT-6.2 API'de akıl yürütme düzeyini nasıl ayarlarım?
/v1/responses isteğinde "reasoning": {"effort": "medium"} gönderin. OpenAI başlangıç için medium öneriyor ve none değerini reddediyor.
GPT-6.2 API isteğim neden temperature ile başarısız oluyor?
OpenAI, GPT-6.2 için temperature ve top_p alanlarının çıkarılmasını söylüyor. Bunları kaldırın ve çıktı uzunluğunu max_output_tokens veya max_tokens ile kontrol edin.
GPT-6.2 API'ye nasıl görsel gönderirim?
/v1/responses uç noktasında, bir input_text bloğunun ardından input_image bloğu (URL veya Data URI) kullanın. PoYo'nun Chat Completions şeması yalnızca string içerik belgeler.