ビデオアセットを作成する

可用性

このページには、Modelflare の資産管理ルートが記載されています。呼び出しには、有効なスマート API キーまたはメディアグループ API キー、使用可能なメディアチャネル、および必要な権限が必要です。

エンドポイント

POST https://modelflare.dev/volc/asset/CreateAsset

認証

Modelflare API キーを使用します。

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

作成、更新、削除リクエストを含む Idempotency-Key を送信します。同じユーザーに対して同じキーを再試行すると、ミューテーションを繰り返さずに、保存された応答が再生されます。

リクエスト

既存のグループにビデオを追加します。返された ID は、処理後にサポートされている Seedance ワークフローで使用できます。

フィールド	タイプ	必須	説明	例
`GroupId`	`string`	はい	対象のアセットグループID。	`group-20260320141746-zsf6b`
`AssetType`	`Video`	はい	`Video`である必要があります。	`Video`
`URL`	`string`	はい	公開ビデオ URL。ビデオ Base64 は受け入れられません。 MP4 または MOV、2 ～ 30 秒、24 ～ 60 FPS、各辺 300 ～ 6000 ピクセル、アスペクト比 0.4 ～ 2.5、480p/720p/1080p/4K、合計 407696 ～ 2086876 ピクセル、200 MB 以下を使用します。	`https://example.com/video.mp4`
`file`	`binary`	いいえ	同じビデオ制約を持つ `URL` の代替となるマルチパート。	`video.mp4`
`Name`	`string`	いいえ	表示/検索名、最大64文字。	`scene-clip`
`model`	`string`	はい		`volc-asset-video`
`ProjectName`	`string`	いいえ	プロジェクト名。ターゲットグループと一致する必要があります。デフォルトは`default`です。	`default`

JSON の例:

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

マルチパート/フォームデータの例:

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

レスポンス

映像は非同期処理に入りました。 Status が Active または Failed になるまで GetAsset をポーリングします。アップロード時の SLA はありません。一般的なビデオには約 9 ～ 12 秒かかりますが、ビジーなレビューキューには約 10 秒から 2 分かかる場合があります。

フィールド	タイプ	必須	説明	例
`Id`	`string`	はい	アセット ID。 `asset://<ID>`はステータスが`Active`になってから使用してください。	`asset-20260528140922-d9646`

応答例：

{
  "Id": "asset-20260528140922-d9646"
}

エラー

ステータス	意味
`400`	リクエストは無効です。
`401`	API キーが見つからないか、または不正です。

エラー本文の例 (返された場合):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

画像、ビデオ、オーディオの作成は非同期です。アセット ID を受信後、ステータスが Active の場合にのみ、GetAsset を呼び出し、asset://<ID> 参照を使用します。