텍스트
응답 조회
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 -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"응답
{
"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
}
}오류
| 상태 | 코드 | 의미 |
|---|---|---|
404 | response_not_found | ID를 찾을 수 없거나, 다른 계정 소유이거나, 삭제되었거나, store: false로 생성되었거나, 보존 기간이 지났습니다. |
502 | upstream_response_read_failed | TokenLab이 해당 응답을 생성한 서비스로부터 응답을 읽어올 수 없습니다. 나중에 다시 시도하십시오. |
503 | response_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