TokenLab

텍스트

응답 조회

ID를 통해 저장된 응답을 조회하거나 백그라운드 응답을 폴링합니다.

GET
/v1/responses/{id}

개요

응답 생성를 통해 생성된 응답을 반환합니다. 이 기능을 사용하여 status가 최종 상태가 될 때까지 background 응답을 폴링하거나, 저장된 응답을 다시 읽어올 수 있습니다.

  • 대상 응답: store가 false로 설정되지 않은 응답 및 background 응답. store: false인 경우, TokenLab은 반환할 데이터를 보관하지 않습니다.
  • 보존 기간: TokenLab은 저장된 응답을 24시간 동안 보관합니다. 일부 응답은 최대 30일까지 조회 가능할 수 있으나, 이에 의존하지 말고 필요한 결과는 직접 저장하십시오. 보존 기간이 지나면 해당 ID는 404를 반환합니다.
  • 소유권: 본인 계정에서 생성된 응답만 읽을 수 있습니다. 다른 계정의 ID를 요청하면 알 수 없는 ID와 마찬가지로 404가 반환됩니다.
  • 상태: queued, in_progress, completed, incomplete, failed, 또는 cancelled. HTTP 코드뿐만 아니라 status를 확인하십시오.

stream 및 starting_after는 응답이 실행 중인 동안 적용됩니다. 완료된 응답은 JSON으로 반환됩니다. include 및 include_obfuscation은 모델이 지원하는 경우 전달됩니다.

예시

요청

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

응답 예시

응답

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

오류

상태코드의미
404response_not_foundID를 찾을 수 없거나, 다른 계정 소유이거나, 삭제되었거나, store: false로 생성되었거나, 보존 기간이 지났습니다.
502upstream_response_read_failedTokenLab이 해당 응답을 생성한 서비스로부터 응답을 읽어올 수 없습니다. 나중에 다시 시도하십시오.
503response_state_unavailable, response_result_unavailable응답 상태를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

id*string

POST /v1/responses에서 반환된 응답 ID.

쿼리 매개변수

include?array<string>

포함할 추가 응답 필드이며, 모델이 지원하는 경우 전달됩니다.

include_obfuscation?boolean

스트리밍 이벤트에 난독화 필드가 포함되는지 여부이며, 모델이 지원하는 경우 전달됩니다.

stream?boolean

응답을 이벤트 스트림으로 가져올지 여부입니다. 응답이 실행 중인 동안 적용되며, 완료된 응답은 JSON으로 반환됩니다.

starting_after?integer

스트리밍 이벤트가 반환되기 시작할 시퀀스 번호입니다. stream이 true일 때만 적용됩니다.

응답

application/json

application/json

application/json

application/json