TokenLab

파일 및 배치

파일 업로드

배치 파일, 이미지 참조 또는 Anthropic 형식의 파일을 업로드합니다.

POST
/v1/files

파일 용도 (File Purposes)

  • 배치 파일: /v1/batches에 대해 purpose=batch를 사용합니다.
  • 이미지/참조 파일: 파일 기반 이미지 요청에 대해 purpose=user_data 또는 purpose=vision을 사용합니다.
  • Anthropic 파일: anthropic-beta: files-api-2025-04-14 헤더를 추가합니다.

제한 사항

용도최대 크기
batch200 MiB
user_data, vision50 MiB
Anthropic 파일500 MB

더 큰 파일을 업로드하면 413 request_too_large가 반환됩니다. batch, user_data, vision 이외의 purpose를 사용하면 400 unsupported_purpose가 반환됩니다. file 없이 요청하면 400 오류가 반환됩니다.

batch 파일은 업로드 후 24시간이 지나면 만료됩니다. 이를 변경하려면 폼 필드 expires_after[anchor]=created_at과 expires_after[seconds]를 3600에서 2592000(30일) 사이의 값으로 전송하십시오. 응답의 expires_at 필드에 만료 시간이 표시됩니다.

예시

요청

cURL
curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

이미지 파일 입력

동일한 /v1/files 경로를 사용하여 /v1/images/edits를 위한 이미지 참조 파일을 업로드할 수 있습니다.

  • purpose=user_data 또는 purpose=vision을 사용합니다.
  • 선택적으로 model을 포함하여 이미지 편집 모델을 선택할 수 있으며, 기본값은 gpt-image-2입니다.
  • 반환된 file_id는 선택한 이미지 편집 구성에 바인딩되며 images[].file_id에서 재사용할 수 있습니다.

Anthropic Files API 모드

  • Anthropic Files를 사용하려면 anthropic-beta: files-api-2025-04-14를 추가합니다.
  • Anthropic 모드에서는 원본 파일을 직접 업로드하며 purpose=batch를 전송하지 마십시오.
  • 반환된 file_id는 현재 워크스페이스에서만 사용할 수 있으며 /v1/messages 요청에서 재사용할 수 있습니다.
  • Anthropic 메시지 콘텐츠에서 업로드된 파일을 참조하려는 경우, Anthropic 네이티브 헤더(x-api-key, anthropic-version 및 필요한 경우 베타 헤더)를 계속 사용하십시오.

응답 예시

응답

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

주요 필드

idstring
파일 ID입니다.
purposestring
파일에 할당된 용도입니다. 업로드 시 batch, user_data 또는 vision을 사용할 수 있습니다.
bytesinteger
바이트 단위의 파일 크기입니다.

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

헤더

anthropic-beta?string

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

요청 본문

multipart/form-data

응답

application/json

application/json

application/json

application/json