Metin
Yanıtı Getir
Bir yanıtı ID ile getirir veya arka plan yanıtını sorgular.
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:
storedeğerifalseolarak ayarlanmamış yanıtlar vebackgroundyanıtları.store: falseile 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
404hatası 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
404hatası döndürür. - Durum:
queued,in_progress,completed,incomplete,failedveyacancelled. Sadece HTTP kodunu değil,statusdeğ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.
İstek
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"Yanıt
{
"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
| Durum | Kod | Anlamı |
|---|---|---|
404 | response_not_found | ID bilinmiyor, başka bir hesaba ait, silinmiş, store: false ile oluşturulmuş veya saklama süresi dolmuş. |
502 | upstream_response_read_failed | TokenLab, yanıtı üreten servisten yanıtı okuyamadı. Daha sonra tekrar deneyin. |
503 | response_state_unavailable, response_result_unavailable | Yanıt durumu geçici olarak kullanılamıyor. Daha sonra tekrar deneyin. |
Yetkilendirme
BearerAuth 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
POST /v1/responses tarafından döndürülen yanıt kimliği.
Sorgu parametreleri
Dahil edilecek ek yanıt alanları, model tarafından desteklendiği yerlerde iletilir.
Akış halindeki olayların, model tarafından desteklendiği yerlerde iletilen karartma (obfuscation) alanlarını içerip içermeyeceği.
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.
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