멀티파트 업로드 시작

MCP 도구

start_file_uploadStart File Upload

요청 제한

Tier 3

API 권한

files:write

프로젝트 역할

소유자관리자멤버

파일 멀티파트 업로드를 시작합니다.

정보

각 파트를 해당 URL로 업로드한 뒤 멀티파트 업로드 완료를 호출해야 합니다.

예시

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": 25000000 }'

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

요청

경로

idstringrequired

프로젝트 ID

본문

namestringrequired

1-255 characters

파일 이름

Example: launch-cut.mp4

sizenumberrequired

Integer, 1-10000000000

파일 크기(바이트)

Example: 25000000

응답

201 Created를 반환합니다.

dataobject

업로드 세션

data.idstring

생성된 파일 ID

Example: FX1234567890ABCD

data.partsarray

업로드 파트 목록

data.parts[].partNumbernumber

파트 번호

Example: 1

data.parts[].urlstring

파트 업로드용 URL

Example: https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6...