파일 및 배치
파일 목록 조회
업로드된 배치(batch) 및 이미지 참조(image-reference) 파일 목록을 조회합니다.
배치 및 이미지 참조 파일 목록을 조회합니다. purpose=batch, purpose=batch_output, purpose=user_data 또는 purpose=vision을 사용하여 필터링할 수 있습니다.
Anthropic Files 헤더를 사용하면 동일한 API를 통해 현재 워크스페이스 내의 Anthropic 형식 파일 목록을 조회할 수 있습니다.
요청
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
-H "Authorization: Bearer sk-your-api-key"필터
- 배치 및 이미지 참조 파일의 경우
limit은 110000(기본값 10000)이며, 페이지네이션을 위해1000(기본값 20)이며,after를 사용할 수 있습니다. Anthropic Files 모드에서는limit이 1after_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
}주요 필드
list입니다.has_more가 true이면 더 많은 결과를 확인할 수 있습니다.인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
쿼리 매개변수
1 <= value <= 100020Anthropic Files 커서. 이 공개 파일 ID 이후의 파일을 반환합니다. Anthropic Files 베타 헤더가 필요하며 before_id와 결합할 수 없습니다.
Anthropic Files 커서. 이 공개 파일 ID 이전의 파일을 반환합니다. Anthropic Files 베타 헤더가 필요하며 after_id와 결합할 수 없습니다.
예약된 Anthropic Files 범위 커서. TokenLab은 현재 이 값을 무시하는 대신 명시적인 지원되지 않음 오류를 반환합니다.
선택적 파일 목적 필터. batch 및 batch_output은 Batch API 파일을, user_data 및 vision은 TokenLab 이미지/참조 파일 바인딩을 다룹니다. Anthropic Files API 모드는 이 쿼리 매개변수가 아닌 Anthropic 헤더에 의해 선택됩니다.
허용 값
- "batch"
- "batch_output"
- "user_data"
- "vision"
헤더
Anthropic Files API 모드를 사용하려면 files-api-2025-04-14를 포함하십시오.
응답
application/json
application/json