Teks

Mengambil Respons

Mengambil respons yang tersimpan berdasarkan ID, atau melakukan polling pada respons latar belakang.

GET
/v1/responses/{id}

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 store tidak diatur ke false, dan respons background. Dengan store: 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, atau cancelled. Periksa status, 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.

Contoh

Permintaan

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

Contoh respons

Respons

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
  }
}

Error

StatusKodeArti
404response_not_foundID tidak dikenal, milik akun lain, telah dihapus, dibuat dengan store: false, atau telah melewati masa retensinya.
502upstream_response_read_failedTokenLab tidak dapat membaca respons dari layanan yang menghasilkannya. Coba lagi nanti.
503response_state_unavailable, response_result_unavailableStatus respons untuk sementara tidak tersedia. Coba lagi nanti.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

id*string

Id respons yang dikembalikan oleh POST /v1/responses.

Parameter query

include?array<string>

Bidang respons tambahan untuk disertakan, diteruskan jika model mendukungnya.

include_obfuscation?boolean

Apakah event streaming menyertakan bidang obfuscation, diteruskan jika model mendukungnya.

stream?boolean

Apakah akan mengambil respons sebagai event stream. Berlaku saat respons masih berjalan; respons yang sudah selesai dikembalikan sebagai JSON.

starting_after?integer

Nomor urut setelah event streaming dikembalikan. Berlaku hanya dengan stream.

Respons

application/json

application/json

application/json

application/json