アップロード開始
POST
https://api.youvico.com/api/projects/:id/generation-attachments/upload.multipart- MCPツール
- 未対応
- レート制限
- Tier 3
- スコープ
- ai:generate
ファイル生成で使う参考ファイルのアップロードを開始します。 APIキーまたは連携が属するワークスペースのプロジェクトでのみ利用できます。ほかのワークスペースから連携されたプロジェクトでは利用できません。
- アップロードは開始から24時間以内に完了します。
- 添付はアップロード開始から23時間以内にファイル生成で使用します。
- 直近24時間にアップロードを開始した添付は、合計10 GBまでです。
補足
- ファイルを先頭から100,000,000バイトずつ分割します。最後のパートは残りのサイズになります。
- 30分以内に、各パートを同じ
partNumberのurlにPUTでアップロードし、レスポンスのETagヘッダーの値を保持します。 - すべての
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
ボディ
namestringrequired1-255 characters
添付ファイル名
例: reference.png
sizenumberrequiredInteger, 1-1000000000
添付ファイルサイズ(バイト)
例: 2400000
レスポンス
201 Created を返します。
dataobjectアップロードセッション
data.idstring作成されたAI生成添付ファイルID
例: GA1234567890ABCD
data.partsarrayアップロードパート