파일 목록

개요Copy Anchor Link

이 엔드포인트는 주로 TokenLab의 OpenAI 호환 Batch API를 대상으로 합니다. 업로드된 배치 입력과 생성된 출력 또는 오류 파일을 포함합니다.

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

Anthropic 헤더가 없으면 목록에 배치 파일과 TokenLab 이미지/참조 파일이 함께 포함될 수 있습니다. purpose=batch, purpose=batch_output, purpose=user_data, purpose=vision으로 범위를 좁힐 수 있습니다.

참고 사항Copy Anchor Link

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

curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -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

• 배치 및 이미지 참조 파일의 limit는 1–10000(기본값 10000)이며 after로 페이지를 넘깁니다. Anthropic Files 모드에서는 1–1000(기본값 20)입니다. 페이지 이동에는 after_id 또는 before_id 중 하나만 사용하세요.
• purpose는 batch, batch_output, user_data, vision 중 하나일 수 있습니다.
• user_data와 vision은 사용 가능한 경우 TokenLab이 생성한 이미지 참조 파일을 반환합니다.

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

중요 필드Copy Anchor Link