Beta

アップロード開始

POSThttps://api.youvico.com/api/projects/:id/generation-attachments/upload.multipart
MCPツール
未対応
レート制限
Tier 3
スコープ
ai:generate
プロジェクトロール
所有者管理者メンバー

ファイル生成で使う参考ファイルのアップロードを開始します。 APIキーまたは連携が属するワークスペースのプロジェクトでのみ利用できます。ほかのワークスペースから連携されたプロジェクトでは利用できません。

  • アップロードは開始から24時間以内に完了します。
  • 添付はアップロード開始から23時間以内にファイル生成で使用します。
  • 直近24時間にアップロードを開始した添付は、合計10 GBまでです。

補足

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

例

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/generation-attachments/upload.multipart' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "reference.png", "size": 2400000 }'
{
  "data": {
    "id": "GA1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      }
    ]
  }
}
リクエスト
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/generation-attachments/upload.multipart' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "reference.png",
"size": 2400000
}'
レスポンス201 Created
{
  "data": {
    "id": "GA1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
      }
    ]
  }
}

リクエスト

パス

idstringrequired
プロジェクトID

ボディ

namestringrequired

1-255 characters

添付ファイル名

例: reference.png

sizenumberrequired

Integer, 1-1000000000

添付ファイルサイズ(バイト)

例: 2400000

レスポンス

201 Created を返します。

dataobject
アップロードセッション
data.idstring
作成されたAI生成添付ファイルID

例: GA1234567890ABCD

data.partsarray
アップロードパート