Metin

Yanıtı Getir

Bir yanıtı ID ile getirir veya arka plan yanıtını sorgular.

GET
/v1/responses/{id}

Genel Bakış

Yanıt Oluştur tarafından oluşturulan bir yanıtı döndürür. Bunu, status değeri nihai olana kadar bir background yanıtını sorgulamak veya depolanmış bir yanıtı tekrar okumak için kullanın.

  • Hangi yanıtlar: store değeri false olarak ayarlanmamış yanıtlar ve background yanıtları. store: false ile TokenLab döndürülecek hiçbir şey tutmaz.
  • Saklama: TokenLab, depolanmış bir yanıtı 24 saat boyunca tutar. Bazıları 30 güne kadar erişilebilir kalabilir, ancak buna güvenmeyin: ihtiyacınız olan sonucu kaydedin. Saklama süresi dolduktan sonra, ID 404 hatası döndürür.
  • Sahiplik: Yalnızca kendi hesabınızda oluşturulan yanıtları okuyabilirsiniz. Başka bir hesaba ait bir ID, bilinmeyen bir ID ile aynı şekilde 404 hatası döndürür.
  • Durum: queued, in_progress, completed, incomplete, failed veya cancelled. Sadece HTTP kodunu değil, status değerini de kontrol edin.

stream ve starting_after parametreleri, yanıt hala çalışıyorken geçerlidir. Tamamlanmış bir yanıt JSON olarak döndürülür. include ve include_obfuscation parametreleri, model tarafından desteklendikleri durumlarda iletilir.

Örnek

İstek

cURL
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Yanıt örneği

Yanıt

200 OK
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1706000000,
  "status": "completed",
  "model": "gpt-5.6-terra",
  "output": [
    {
      "id": "msg_abc123",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
      ]
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "total_tokens": 22
  }
}

Hatalar

DurumKodAnlamı
404response_not_foundID bilinmiyor, başka bir hesaba ait, silinmiş, store: false ile oluşturulmuş veya saklama süresi dolmuş.
502upstream_response_read_failedTokenLab, yanıtı üreten servisten yanıtı okuyamadı. Daha sonra tekrar deneyin.
503response_state_unavailable, response_result_unavailableYanıt durumu geçici olarak kullanılamıyor. Daha sonra tekrar deneyin.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

id*string

POST /v1/responses tarafından döndürülen yanıt kimliği.

Sorgu parametreleri

include?array<string>

Dahil edilecek ek yanıt alanları, model tarafından desteklendiği yerlerde iletilir.

include_obfuscation?boolean

Akış halindeki olayların, model tarafından desteklendiği yerlerde iletilen karartma (obfuscation) alanlarını içerip içermeyeceği.

stream?boolean

Yanıtın bir olay akışı (event stream) olarak alınıp alınmayacağı. Yanıt hala çalışırken geçerlidir; tamamlanmış bir yanıt JSON olarak döndürülür.

starting_after?integer

Akış olaylarının döndürüleceği sıra numarası. Yalnızca stream ile birlikte geçerlidir.

Yanıt

application/json

application/json

application/json

application/json