ファイル生成

MCPツール

generate_fileGenerate File

レート制限

Tier 2

スコープ

ai:generate

プロジェクトロール

所有者管理者メンバー

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 '{ "outputType": "VIDEO", "outputModel": "seedance-2.0", "prompt": "Turn <#FX1234567890ABCD> into a 10-second teaser.", "folder": { "id": "DX1234567890ABCD" }, "attachments": [{ "id": "FX1234567890ABCD" }], "configs": { "durationSeconds": 10, "aspectRatio": "9:16" } }'

{
  "data": {
    "id": "FXABCDEFGHIJKLMN"
  }
}

リクエスト

パス

idstringrequired

プロジェクトID

ボディ

outputTypestringrequired

出力ファイルの種類

Possible values: DOCUMENTIMAGEVIDEO3D

Example: VIDEO

outputModelstringrequired

outputType の生成モデル

Possible values: pdfmarkdowngpt-image-2.5-flaregpt-image-2gemini-3-pro-imagegemini-3.1-flash-imagegemini-3.1-flash-lite-imageseedance-2.5seedance-2.0seedance-2.0-fastseedance-2.0-minikling-3.0-omnikling-3.0kling-3.0-turbominimax-h3-maxminimax-h3veo-3.1-generate-previewveo-3.1-lite-generate-previewmeshy-7hunyuan3d-3.1

Example: seedance-2.0

promptstringrequired

1-5000 characters

生成プロンプト

folderobject?required

作成先フォルダー。null の場合はプロジェクトルート

folder.idstringrequired

フォルダーID

Example: DX1234567890ABCD

attachmentsarrayrequired

0-5 items

参考ファイル

attachments[].idstringrequired

プロジェクトファイルID（FX）またはAI生成添付ファイルID（GA）

Example: FX1234567890ABCD

configsobject

動画の詳細設定

configs.generateAudioboolean

音声を生成するかどうか

configs.resolutionstring

出力解像度

configs.durationSecondsnumber

出力の長さ（秒）

Example: 10

configs.aspectRatiostring

出力のアスペクト比

Example: 9:16

レスポンス

202 Accepted を返します。

dataobject

生成中のファイル

data.idstring

作成されたファイルのID

Example: FXABCDEFGHIJKLMN

モデル

モデル一覧は、これらのモデルを名前と詳細設定とともに返します。

ファイルの種類	モデル
DOCUMENT	pdf, markdown
IMAGE	gpt-image-2.5-flare, gpt-image-2, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image
VIDEO	seedance-2.5, seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, kling-3.0-omni, kling-3.0, kling-3.0-turbo, minimax-h3-max, minimax-h3, veo-3.1-generate-preview, veo-3.1-lite-generate-preview
3D	meshy-7, hunyuan3d-3.1

詳細設定

configs は動画モデルのみ受け付けます。

モデル	解像度	長さ（秒）	アスペクト比	音声
seedance-2.5	480p, 720p, 1080p	4-30	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	はい
seedance-2.0	480p, 720p, 1080p, 4k	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	はい
seedance-2.0-fast	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	はい
seedance-2.0-mini	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	はい
kling-3.0-omni	720p, 1080p	3-15	16:9, 9:16, 1:1	はい
kling-3.0	720p, 1080p	3-15	16:9, 9:16, 1:1	はい
kling-3.0-turbo	720p, 1080p	3-15	16:9, 9:16, 1:1	はい
minimax-h3-max	480p, 768p, 1080p	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	いいえ
minimax-h3	768p, 2k	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	いいえ
veo-3.1-generate-preview	720p, 1080p, 4k	8	16:9, 9:16	はい
veo-3.1-lite-generate-preview	720p, 1080p	8	16:9, 9:16	はい