TokenLab

파일 및 배치

배치 조회

배치의 현재 상태, 요청 수 및 결과 파일을 조회합니다.

GET
/v1/batches/{batch_id}

개요

배치 상태, 요청 수 및 결과 파일 ID를 반환합니다. 알 수 없는 배치 ID이거나 다른 Workspace의 배치인 경우 404 batch_not_found를 반환합니다.

status는 validating, queued, in_progress, finalizing, completed, failed, cancelling, cancelled 또는 expired 중 하나입니다. status가 completed가 되면 결과 파일이 준비된 상태입니다. 파일 내용 조회를 통해 확인할 수 있습니다.

예시

요청

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

응답 예시

응답

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "status": "completed",
  "input_file_id": "file_abc123",
  "output_file_id": "file_out123",
  "error_file_id": "file_err123",
  "request_counts": { "total": 100, "completed": 98, "failed": 2 }
}

주요 필드

request_countsobject
전체, 완료, 실패 및 취소된 요청 수입니다.
output_file_idstring|null
성공한 결과 파일 ID입니다.
error_file_idstring|null
실패한 결과 파일 ID입니다.

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

경로 매개변수

batch_id*string

응답

application/json

application/json

application/json