메인 콘텐츠로 건너뛰기
POST
/
api
/
v1
/
files
/
upload
/
stream
파일 스트림 업로드
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/stream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "success": true,
  "code": 200,
  "msg": "파일이 성공적으로 업로드되었습니다",
  "data": {
    "file_id": "file_abc123",
    "file_name": "photo.png",
    "original_name": "photo.png",
    "file_size": 2048,
    "mime_type": "image/png",
    "upload_path": "photos",
    "file_url": "https://files.evolink.ai/photos/photo.png",
    "download_url": "https://files.evolink.ai/api/v1/files/download/file_abc123",
    "upload_time": "2025-10-09T00:00:00+08:00",
    "expires_at": "2025-10-12T00:00:00+08:00"
  }
}

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

multipart/form-data
file
file
필수

파일 바이너리 데이터

참고:

  • form-data 형식으로 업로드
  • 시스템이 파일 유형을 자동으로 식별합니다
  • 요청당 최대 1개 이미지
  • 현재 image/jpeg, image/png, image/gif, image/webp 형식의 파일만 업로드 가능합니다
upload_path
string

사용자 정의 업로드 경로

참고:

  • 언더스코어 명명 지원: upload_path
  • 카멜케이스 명명 지원: uploadPath
  • 지정하지 않으면 시스템이 파일 유형에 따라 자동으로 분류합니다
예시:

"photos"

file_name
string

사용자 정의 파일 이름

참고:

  • 언더스코어 명명 지원: file_name
  • 카멜케이스 명명 지원: fileName
  • 지정하지 않으면 시스템이 자동으로 고유한 파일 이름을 생성합니다
예시:

"photo.png"

응답

200 - application/json

파일이 성공적으로 업로드되었습니다

success
boolean

요청 성공 여부

예시:

true

code
integer

응답 상태 코드

예시:

200

msg
string

응답 메시지

예시:

"파일이 성공적으로 업로드되었습니다"

data
object