파일 및 배치
파일 내용 가져오기
업로드된 파일의 원본 내용을 다운로드합니다.
개요
이 엔드포인트는 주로 TokenLab의 OpenAI 호환 Batch API 파일 내용 조회를 대상으로 합니다.
요청이 Anthropic Files 호환 모드를 선택한 경우, 같은 경로에서 바인딩된 작업공간의 원본 저장 파일 내용을 프록시할 수 있습니다.
Anthropic 헤더가 없으면 이 라우트는 배치 파일 내용을 다운로드합니다. 제공업체가 파일 내용 조회를 지원하면 바인딩된 이미지/참조 파일 내용도 프록시합니다.
참고 사항
- 배치 입력 파일은
purpose=batch를 사용해야 합니다. completion_window는 현재24h입니다.- 출력 순서는 보장되지 않으므로 항상
custom_id로 일치시켜야 합니다. - 배치 항목 내에서는 스트리밍이 지원되지 않습니다.
요청
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이 생성한 이미지 참조 콘텐츠는 백킹 파일 제공자가 콘텐츠 조회를 지원하는 경우 바이너리 콘텐츠로 프록시될 수 있습니다.
응답
{"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