TokenLab

파일 및 배치

파일 내용 가져오기

업로드된 파일의 원본 내용을 다운로드합니다.

GET
/v1/files/{file_id}/content

개요

이 엔드포인트는 주로 TokenLab의 OpenAI 호환 Batch API 파일 내용 조회를 대상으로 합니다.

요청이 Anthropic Files 호환 모드를 선택한 경우, 같은 경로에서 바인딩된 작업공간의 원본 저장 파일 내용을 프록시할 수 있습니다.

Anthropic 헤더가 없으면 이 라우트는 배치 파일 내용을 다운로드합니다. 제공업체가 파일 내용 조회를 지원하면 바인딩된 이미지/참조 파일 내용도 프록시합니다.

참고 사항

  • 배치 입력 파일은 purpose=batch를 사용해야 합니다.
  • completion_window는 현재 24h입니다.
  • 출력 순서는 보장되지 않으므로 항상 custom_id로 일치시켜야 합니다.
  • 배치 항목 내에서는 스트리밍이 지원되지 않습니다.

예시

요청

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

요청 / 응답

정확한 스키마는 위의 대화형 OpenAPI 패널을 참고하세요.

운영 팁

  • 다운스트림 조정을 멱등적으로 하려면 custom_id를 사용하세요.
  • 작업자가 배치를 최종화한 뒤에만 output_file_id와 error_file_id가 생깁니다.

콘텐츠 유형

배치 파일 콘텐츠는 JSONL 또는 일반 텍스트로 반환됩니다. TokenLab이 생성한 이미지 참조 콘텐츠는 백킹 파일 제공자가 콘텐츠 조회를 지원하는 경우 바이너리 콘텐츠로 프록시될 수 있습니다.

응답 예시

응답

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

중요 필드

bodybinary|string
파일 내용입니다. Content-Type에 따라 저장하거나 파싱하세요. JSONL은 한 줄씩 파싱합니다.
custom_idstring
배치 입력 항목과 결과를 연결하는 ID입니다.

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

경로 매개변수

file_id*string

응답

text/plain

application/json