ファイル生成
https://api.youvico.com/api/projects/:id/files/upload.generate- MCPツール
- 未対応
- レート制限
- Tier 2
- スコープ
- ai:generate
選択した生成モードでAIファイルを生成します。
AUTOはプロンプトと添付を分析して生成方法を自動で決めます。configsで指定した出力設定はそのまま使用します。ADVANCEDはプロンプトとconfigsのとおりに生成します。添付はすべてconfigsの添付スロットに指定します。
ADVANCED でモデルのルール上使用できない添付がある場合は、エラーレスポンスの error.details.attachment.id にその添付のID、error.details.reason に理由を返します。
APIキーまたは連携が属するワークスペースのプロジェクトでのみ利用できます。ほかのワークスペースから連携されたプロジェクトでは利用できません。
補足
例
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.generate' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "mode": "ADVANCED", "output": { "type": "VIDEO", "model": "kling-3.0" }, "prompt": "The camera slowly pushes in as the sneaker turns on a turntable.", "folder": { "id": "DX1234567890ABCD" }, "attachments": [{ "id": "GA1234567890ABCD" }], "configs": { "start": "GA1234567890ABCD", "durationSeconds": 10 } }'
{
"data": {
"id": "FXABCDEFGHIJKLMN"
}
}
{
"data": {
"id": "FXABCDEFGHIJKLMN"
}
}
リクエスト
パス
idstringrequiredボディ
modestringrequired指定できる値: AUTOADVANCED
例: ADVANCED
outputobjectrequiredoutput.typestringrequired指定できる値: PDFMARKDOWNIMAGEVIDEO3DMUSICTTSSTT
例: VIDEO
output.modelstringrequired例: kling-3.0
promptstringrequired0-20000 characters
例: The camera slowly pushes in as the sneaker turns on a turntable.
folderobject?requiredfolder.idstringrequired例: DX1234567890ABCD
attachmentsarrayrequired0-50 items, unique IDs
attachments[].idstringrequired例: GA1234567890ABCD
configsobject補足
ADVANCED では attachments のIDをすべて configs の添付スロットに指定する必要があり、添付スロットにほかのIDは指定できません。
レスポンス
202 Accepted を返します。
dataobjectdata.idstring例: FXABCDEFGHIJKLMN
モデル
モデル一覧がモデルごとの設定スキーマを返します。ドキュメントモデル(PDF、MARKDOWN)と音声モデル(TTS、STT)は ADVANCED のみに対応します。
| 出力形式 | モデル |
|---|---|
PDF | claude-fable-5-2, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6.2-astra, gpt-6-astra, gpt-6.2-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna, gemini-4-carbon, gemini-4-argon, gemini-4-neon, gemini-4-hydrogen, gemini-3.8-flash |
MARKDOWN | claude-fable-5-2, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6.2-astra, gpt-6-astra, gpt-6.2-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna, gemini-4-carbon, gemini-4-argon, gemini-4-neon, gemini-4-hydrogen, gemini-3.8-flash |
IMAGE | gpt-image-2.6-flare, gpt-image-2.6-sunburst, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gemini-nano-banana-2.1, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image, seedream-5.5 |
VIDEO | kling-4.0, kling-4.0-omni, seedance-2.5, seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, kling-3.0-omni, kling-3.0-turbo, minimax-h3-max, minimax-h3, wan-3.0, wan-3.0-prime, gemini-omni-flash, veo-3.1-generate-preview, veo-3.1-lite-generate-preview |
3D | meshy-7.1, hunyuan3d-3.1 |
MUSIC | lyria-3.5 |
TTS | eleven-v4, eleven-v4-turbo |
STT | mai-transcribe-2, nemotron-3.5-transcribe |
設定
受け付ける値とデフォルト値はモデルごとのスキーマにあります。AUTO で送らなかった設定は YouViCo が決め、ADVANCED ではデフォルト値を使用します。
| 設定 | 説明 |
|---|---|
effort | 思考レベル。高いほど長く考える |
aspectRatio | アスペクト比。adaptive は入力画像・動画の比率に従う |
resolution | 出力解像度 |
quality | 画像の品質 |
complexity | 画像の構想にかける計算量。品質とは別 |
outputFormat | 画像・音声・テキストのファイル形式 |
transparent | 背景を透明にするかどうか。outputFormat が jpeg の場合は false のみ |
durationSeconds | 出力の長さ(秒) |
generateAudio | 音声を生成するかどうか |
shouldTexture | テクスチャを適用するかどうか |
voice | TTS の音声 ID。おすすめの音声はスキーマの x-voices |
diarize | STT で話者を区別するかどうか |
MUSIC モデルの設定は outputFormat のみです。ADVANCED では、歌詞、長さ、テンポ、キーをプロンプトに記述します。
TTS はプロンプトを読み上げた音声を生成します。STT は audio スロットの音声を文字起こしし、プロンプトには空文字列を送ります。
添付スロット
添付スロットは ADVANCED スキーマにのみあります。モデルごとのスロットとスロット間のルールは、各モデルのスキーマで確認できます。
| スロット | 説明 |
|---|---|
references | 参照画像・動画・音声・ドキュメント |
start, end | 開始・終了フレーム画像 |
middle | 開始・終了フレームの間に時間順で入れる中間フレーム画像。start は必須 |
edit | 編集する動画。出力の長さと比率はこの動画に従う |
extend | durationSeconds 分だけ延長する動画 |
motion | モーションコントロール。image と video は必須 |
audio | STT で文字起こしする音声 |
images | 3D の入力画像。hunyuan3d-3.1 は視点をキーとするオブジェクトで、front は必須 |
一部の動画モデルは、出力で避ける内容を指定する negativePrompt と、合計が出力の長さと同じ prompt・seconds のリストであるマルチショット shots も受け付けます。