파일 가져오기

개요Copy Anchor Link

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

요청이 Anthropic Files 호환 모드를 선택한 경우, 같은 경로에서 바인딩된 작업공간의 Anthropic 스타일 파일 메타데이터도 반환할 수 있습니다.

Anthropic 헤더가 없으면 이 라우트는 배치 파일 객체 또는 TokenLab 이미지/참조 파일 객체를 반환할 수 있습니다.

참고 사항Copy Anchor Link

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

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

요청 / 응답Copy Anchor Link

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

운영 팁Copy Anchor Link

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

이미지 참조 파일Copy Anchor Link

이 엔드포인트는 TokenLab이 생성한 이미지 참조 파일의 메타데이터도 반환할 수 있습니다. status 필드는 선택 사항이며 해당 값을 제공하지 않는 파일 계열에서는 없을 수 있습니다.

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

중요 필드Copy Anchor Link