파일 및 배치
파일 업로드
배치 파일, 이미지 참조 또는 Anthropic 형식의 파일을 업로드합니다.
파일 용도 (File Purposes)
- 배치 파일:
/v1/batches에 대해purpose=batch를 사용합니다. - 이미지/참조 파일: 파일 기반 이미지 요청에 대해
purpose=user_data또는purpose=vision을 사용합니다. - Anthropic 파일:
anthropic-beta: files-api-2025-04-14헤더를 추가합니다.
제한 사항
| 용도 | 최대 크기 |
|---|---|
batch | 200 MiB |
user_data, vision | 50 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 -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및 필요한 경우 베타 헤더)를 계속 사용하십시오.
응답
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}주요 필드
batch, user_data 또는 vision을 사용할 수 있습니다.인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
Anthropic Files API 모드를 사용하려면 files-api-2025-04-14를 포함하십시오.
요청 본문
multipart/form-data
응답
application/json
application/json
application/json
application/json