Beta

ファイル生成

POSThttps://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キーまたは連携が属するワークスペースのプロジェクトでのみ利用できます。ほかのワークスペースから連携されたプロジェクトでは利用できません。

補足

AI生成の結果を確認するには、status が UPLOADED(成功)または FAILED(失敗)になるまでファイル取得を繰り返し呼び出します。進行状況と失敗理由はAIジョブ取得で確認できます。

例

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"
  }
}
リクエスト
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
}
}'
レスポンス202 Accepted
{
  "data": {
    "id": "FXABCDEFGHIJKLMN"
  }
}

リクエスト

パス

idstringrequired
プロジェクトID

ボディ

modestringrequired
生成モード

指定できる値: AUTOADVANCED

例: ADVANCED

outputobjectrequired
出力形式とモデル
output.typestringrequired
出力形式

指定できる値: PDFMARKDOWNIMAGEVIDEO3DMUSICTTSSTT

例: VIDEO

output.modelstringrequired
output.type のモデルID。下記のモデルを参照

例: kling-3.0

promptstringrequired

0-20000 characters

生成プロンプト

例: The camera slowly pushes in as the sneaker turns on a turntable.

folderobject?required
作成先フォルダー。null の場合はプロジェクトルート
folder.idstringrequired
フォルダーID

例: DX1234567890ABCD

attachmentsarrayrequired

0-50 items, unique IDs

参考ファイル
attachments[].idstringrequired
プロジェクトファイルID(FX)またはAI生成添付ファイルID(GA)

例: GA1234567890ABCD

configsobject
設定。モデルのモード別スキーマに従う必要あり

補足

ADVANCED では attachments のIDをすべて configs の添付スロットに指定する必要があり、添付スロットにほかのIDは指定できません。

レスポンス

202 Accepted を返します。

dataobject
生成中のファイル
data.idstring
作成されたファイルのID

例: FXABCDEFGHIJKLMN

モデル

モデル一覧がモデルごとの設定スキーマを返します。ドキュメントモデル(PDF、MARKDOWN)と音声モデル(TTS、STT)は ADVANCED のみに対応します。

出力形式モデル
PDFclaude-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
MARKDOWNclaude-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
IMAGEgpt-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
VIDEOkling-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
3Dmeshy-7.1, hunyuan3d-3.1
MUSIClyria-3.5
TTSeleven-v4, eleven-v4-turbo
STTmai-transcribe-2, nemotron-3.5-transcribe

設定

受け付ける値とデフォルト値はモデルごとのスキーマにあります。AUTO で送らなかった設定は YouViCo が決め、ADVANCED ではデフォルト値を使用します。

設定説明
effort思考レベル。高いほど長く考える
aspectRatioアスペクト比。adaptive は入力画像・動画の比率に従う
resolution出力解像度
quality画像の品質
complexity画像の構想にかける計算量。品質とは別
outputFormat画像・音声・テキストのファイル形式
transparent背景を透明にするかどうか。outputFormat が jpeg の場合は false のみ
durationSeconds出力の長さ(秒)
generateAudio音声を生成するかどうか
shouldTextureテクスチャを適用するかどうか
voiceTTS の音声 ID。おすすめの音声はスキーマの x-voices
diarizeSTT で話者を区別するかどうか

MUSIC モデルの設定は outputFormat のみです。ADVANCED では、歌詞、長さ、テンポ、キーをプロンプトに記述します。

TTS はプロンプトを読み上げた音声を生成します。STT は audio スロットの音声を文字起こしし、プロンプトには空文字列を送ります。

添付スロット

添付スロットは ADVANCED スキーマにのみあります。モデルごとのスロットとスロット間のルールは、各モデルのスキーマで確認できます。

スロット説明
references参照画像・動画・音声・ドキュメント
start, end開始・終了フレーム画像
middle開始・終了フレームの間に時間順で入れる中間フレーム画像。start は必須
edit編集する動画。出力の長さと比率はこの動画に従う
extenddurationSeconds 分だけ延長する動画
motionモーションコントロール。image と video は必須
audioSTT で文字起こしする音声
images3D の入力画像。hunyuan3d-3.1 は視点をキーとするオブジェクトで、front は必須

一部の動画モデルは、出力で避ける内容を指定する negativePrompt と、合計が出力の長さと同じ prompt・seconds のリストであるマルチショット shots も受け付けます。