Teks
Mengambil Respons
Mengambil respons yang tersimpan berdasarkan ID, atau melakukan polling pada respons latar belakang.
Gambaran Umum
Mengembalikan respons yang dibuat oleh Buat Respons. Gunakan ini untuk melakukan polling pada respons background hingga status-nya final, atau untuk membaca kembali respons yang tersimpan.
- Respons mana saja: Respons yang dibuat dengan
storetidak diatur kefalse, dan responsbackground. Denganstore: false, TokenLab tidak menyimpan apa pun untuk dikembalikan. - Retensi: TokenLab menyimpan respons yang tersimpan selama 24 jam. Beberapa tetap dapat diambil hingga 30 hari, namun jangan mengandalkan hal tersebut: simpan hasil yang Anda perlukan. Setelah masa retensinya berakhir, ID tersebut akan mengembalikan
404. - Kepemilikan: Anda hanya dapat membaca respons yang dibuat di akun Anda sendiri. ID dari akun lain akan mengembalikan
404, sama seperti ID yang tidak dikenal. - Status:
queued,in_progress,completed,incomplete,failed, ataucancelled. Periksastatus, jangan hanya kode HTTP-nya.
stream dan starting_after berlaku saat respons masih berjalan. Respons yang sudah selesai dikembalikan sebagai JSON. include dan include_obfuscation diteruskan jika model mendukungnya.
Permintaan
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"Respons
{
"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
}
}Error
| Status | Kode | Arti |
|---|---|---|
404 | response_not_found | ID tidak dikenal, milik akun lain, telah dihapus, dibuat dengan store: false, atau telah melewati masa retensinya. |
502 | upstream_response_read_failed | TokenLab tidak dapat membaca respons dari layanan yang menghasilkannya. Coba lagi nanti. |
503 | response_state_unavailable, response_result_unavailable | Status respons untuk sementara tidak tersedia. Coba lagi nanti. |
Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
Id respons yang dikembalikan oleh POST /v1/responses.
Parameter query
Bidang respons tambahan untuk disertakan, diteruskan jika model mendukungnya.
Apakah event streaming menyertakan bidang obfuscation, diteruskan jika model mendukungnya.
Apakah akan mengambil respons sebagai event stream. Berlaku saat respons masih berjalan; respons yang sudah selesai dikembalikan sebagai JSON.
Nomor urut setelah event streaming dikembalikan. Berlaku hanya dengan stream.
Respons
application/json
application/json
application/json
application/json