TokenLab

파일 및 배치

파일 목록 조회

업로드된 배치(batch) 및 이미지 참조(image-reference) 파일 목록을 조회합니다.

GET
/v1/files

배치 및 이미지 참조 파일 목록을 조회합니다. purpose=batch, purpose=batch_output, purpose=user_data 또는 purpose=vision을 사용하여 필터링할 수 있습니다.

Anthropic Files 헤더를 사용하면 동일한 API를 통해 현재 워크스페이스 내의 Anthropic 형식 파일 목록을 조회할 수 있습니다.

예시

요청

cURL
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

필터

  • 배치 및 이미지 참조 파일의 경우 limit은 110000(기본값 10000)이며, 페이지네이션을 위해 after를 사용할 수 있습니다. Anthropic Files 모드에서는 limit이 11000(기본값 20)이며, after_id 또는 before_id 중 하나만 사용해야 합니다(둘 다 동시에 사용할 수 없음).
  • purpose는 batch, batch_output, user_data 또는 vision일 수 있습니다.
  • user_data 및 vision은 사용 가능한 경우 TokenLab에서 생성한 이미지 참조 파일을 반환합니다.

응답 예시

응답

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

주요 필드

objectstring
항상 list입니다.
dataarray
파일 목록입니다.
has_moreboolean
has_more가 true이면 더 많은 결과를 확인할 수 있습니다.

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

쿼리 매개변수

limit?integer
범위1 <= value <= 1000
기본값20
after?string
after_id?string

Anthropic Files 커서. 이 공개 파일 ID 이후의 파일을 반환합니다. Anthropic Files 베타 헤더가 필요하며 before_id와 결합할 수 없습니다.

before_id?string

Anthropic Files 커서. 이 공개 파일 ID 이전의 파일을 반환합니다. Anthropic Files 베타 헤더가 필요하며 after_id와 결합할 수 없습니다.

scope_id?string

예약된 Anthropic Files 범위 커서. TokenLab은 현재 이 값을 무시하는 대신 명시적인 지원되지 않음 오류를 반환합니다.

purpose?string

선택적 파일 목적 필터. batch 및 batch_output은 Batch API 파일을, user_data 및 vision은 TokenLab 이미지/참조 파일 바인딩을 다룹니다. Anthropic Files API 모드는 이 쿼리 매개변수가 아닌 Anthropic 헤더에 의해 선택됩니다.

허용 값

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

헤더

anthropic-beta?string

Anthropic Files API 모드를 사용하려면 files-api-2025-04-14를 포함하십시오.

응답

application/json

application/json