マルチパートアップロード開始 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