파일 업로드

개요Copy Anchor Link

이 엔드포인트는 TokenLab의 OpenAI 호환 배치 API의 일부입니다. 배치 작업은 업로드된 JSONL 파일을 사용하며 비동기적으로 실행되며 나중에 출력/오류 파일을 반환할 수 있습니다.

지원되는 파일 모드Copy Anchor Link

TokenLab은 /v1/files를 세 가지 명시적 모드로 처리합니다:

• 배치 파일: /v1/batches에 purpose=batch를 사용합니다.
• 이미지/참조 파일: 파일 기반 이미지 요청에 purpose=user_data 또는 purpose=vision을 사용합니다.
• Anthropic Files API 모드: Anthropic 네이티브 파일 저장에는 anthropic-beta: files-api-2025-04-14를 추가합니다.

주의사항Copy Anchor Link

• 배치 입력 파일은 purpose=batch를 사용해야 합니다.
• completion_window는 현재 24h입니다.
• 출력 순서는 보장되지 않으며, 항상 custom_id로 일치시켜야 합니다.
• 배치 항목 내에서 스트리밍은 지원되지 않습니다.

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"

요청 / 응답Copy Anchor Link

정확한 스키마를 위해 위의 대화형 OpenAPI 패널을 사용하세요.

운영 팁Copy Anchor Link

• 멱등성 있는 다운스트림 조정을 위해 custom_id를 사용하세요.
• 작업자가 배치를 완료한 후에만 output_file_id와 error_file_id를 기대하세요.

이미지 파일 입력Copy Anchor Link

같은 /v1/files 경로에서 /v1/images/edits용 이미지 참조 파일도 업로드할 수 있습니다.

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

Anthropic Files API 모드Copy Anchor Link

이 /v1/files 라우트는 Anthropic Files API 경로도 지원합니다.

• anthropic-beta: files-api-2025-04-14 헤더를 추가하면 Anthropic 모드로 전환됩니다.
• Anthropic 모드에서는 원본 파일을 직접 업로드하고 purpose=batch 는 보내지 마세요.
• 반환된 file_id는 동일한 Anthropic 호환 워크스페이스 범위에서 사용할 수 있으며 이후 /v1/messages 요청에서 재사용해야 합니다.
• Anthropic 메시지 콘텐츠에서 해당 파일을 참조하려면 Anthropic 네이티브 헤더(x-api-key, anthropic-version, 필요 시 beta header)를 계속 사용하세요.

파일 만료Copy Anchor Link

배치 입력 파일은 선택적으로 expires_after[anchor]=created_at 및 expires_after[seconds]로 만료 창을 설정할 수 있습니다. 초 값은 3600 이상 2592000 이하여야 합니다.

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

중요 필드Copy Anchor Link