멀티파트 업로드 시작 Tier 3

POST/api/projects/:id/files/upload.multipartCopied!

파일을 생성하고 멀티파트 업로드용 presigned URL을 반환합니다. 파트는 100 MB 단위로 생성되며, 최대 파일 크기는 10 GB입니다.

일반적인 파일 업로드는 이 엔드포인트를 직접 호출하기보다 SDK files.upload 헬퍼로 처리하는 것을 권장합니다. 파일 업로드를 참고하세요.

CLI 호출 불가 엔드포인트

CLI는 로컬 파일 업로드를 SDK files.upload 헬퍼로 자동 처리합니다. 따라서 CLI에서는 이 엔드포인트를 직접 호출할 수 없습니다.

예시

SDK

const upload = await client.files.startMultipartUpload("bdbff5de-96d7-468f-9db0-85fe28bd6b62", {
  name: "launch-cut.mp4",
  size: 250000000,
});

CLI

youvico file upload.file --project=bdbff5de-96d7-468f-9db0-85fe28bd6b62 --path=./launch-cut.mp4 --name=launch-cut.mp4

cURL

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.multipart' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "launch-cut.mp4", "size": 250000000 }'

{
  "data": {
    "id": "FX1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://example.com/upload/1"
      },
      {
        "partNumber": 2,
        "url": "https://example.com/upload/2"
      },
      {
        "partNumber": 3,
        "url": "https://example.com/upload/3"
      }
    ]
  }
}

요청

경로

idstringrequired

프로젝트 ID

본문

namestringrequired

1–255 characters

파일 이름

sizenumberrequired

1–10000000000

파일 크기(bytes)

응답

201 Created를 반환합니다.

dataobject

업로드 세션

data.idstring

생성된 파일 ID

Example: FX1234567890ABCD

data.partsarray

업로드 파트

data.parts[].partNumbernumber

파트 번호

Example: 1

data.parts[].urlstring

파트 업로드용 presigned URL

Example: https://example.com/upload/1