how-tos

GPT-6.2 API Kılavuzu: cURL ve Python ile İlk İstek, Responses ve Chat Completions

Poyo.ai Team
8 min read
Share:

GPT-6.2 API kılavuzu: cURL ve Python ile ilk istek

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çimUç noktaNe zaman kullanılır
ResponsesPOST https://api.poyo.ai/v1/responsesYeni kod, fonksiyon araçları, görsel girdi, akıl yürütme düzeyi
Chat CompletionsPOST https://api.poyo.ai/v1/chat/completionsMevcut 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:

  1. temperature veya top_p göndermeyin. OpenAI bunların yanı sıra Chat Completions'ta logprobs ve top_logprobs, Responses'ta ise top_logprobs alanlarının da çıkarılmasını söylüyor. PoYo'nun şemaları eski modeller için temperature ve top_p alanlarını hâlâ listeliyor.
  2. Akıl yürütme düzeyini none olarak ayarlamayın; API bunu reddeder.
  3. Sabit talimatları input'un başındaki bir developer mesajına koyun. GPT-6.2, üst düzey instructions alanı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.

DurumAyarKaynak
Yeni entegrasyonmediumOpenAI: "Yeni bir entegrasyon için medium ile başlayın."
Önceden none veya minimallowOpenAI GPT-6.2 geçiş notu
Uzun veya karmaşık görevlerDaha yüksek bir düzeyOpenAI: daha yüksek düzey "son kontrollere kadar sebat etmesine yardımcı olabilir"
noneReddedilirOpenAI 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

HTTPNedenNe yapılmalı
400Geçersiz alan (validation_error, ayrıntılar listelenir)Gövdeyi düzeltin; none düzeyi veya belgelenmemiş bir alan buraya düşebilir
401Eksik veya geçersiz API anahtarıAuthorization başlığını kontrol edin
402Yetersiz krediYeniden denemeden önce bakiye yükleyin
404Bilinmeyen model (model_not_found)Kimliği kontrol edin: gpt-6.2-sol, gpt-6.2-astra
429Hız sınırıBekleyip yeniden deneyin
500 / 502 / 503Sunucu 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_KEY anahtarı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 temperature ve top_p alanlarını kaldırın.
  • Her zaman max_output_tokens (veya max_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_reason ile usage bloğunun tamamını kendi istek kimliğinizin yanında loglayın.
  • Uzun, sabit bağlamı ilk developer mesajı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-sol ile gpt-6.2-astra arası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.

Share: