マルチパートアップロード開始

POSThttps://api.youvico.com/api/projects/:id/files/upload.multipart

MCPツール: start_file_uploadStart File Upload
レート制限: Tier 3
スコープ: files:write
プロジェクトロール: 所有者管理者メンバー

ファイルのマルチパートアップロードを開始します。

補足

ファイルを先頭から10,000,000バイトずつ分割します。最後のパートは残りのサイズになります。
30分以内に、各パートを同じ partNumber の url にPUTでアップロードし、レスポンスの ETag ヘッダーの値を保持します。
すべての partNumber と eTag を指定してマルチパートアップロード完了を呼び出します。

例

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, "folder": { "id": "DX1234567890ABCD" } }'

{
  "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..."
      }
    ]
  }
}

リクエスト

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,

"folder": {

"id": "DX1234567890ABCD"

}

レスポンス201 Created

{
  "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

ファイル名

例: launch-cut.mp4

sizenumberrequired

Integer, 1-10000000000

ファイルサイズ（バイト）

例: 25000000

folderobject?

アップロード先フォルダー。省略または null の場合はプロジェクトルート

folder.idstringrequired

フォルダーID

例: DX1234567890ABCD

レスポンス

201 Created を返します。

dataobject

アップロードセッション

data.idstring

作成されたファイルID

例: FX1234567890ABCD

data.partsarray

アップロードパート