Skip to main content
POST

認証

string
必須
すべてのリクエストに Bearer Token 認証が必要ですAPI Key の取得:API Key 管理ページ にアクセスして API Key を取得してください各リクエストに以下のヘッダーを追加してください:

リクエストパラメータ

object
アセットグループ情報group_id を指定しない場合、サーバーはこのフィールドをもとに AIGC タイプのアセットグループを自動作成します例:
group_id と同時に指定することはできません。どちらか一方を使用してください
string
既存アセットグループ ID指定した場合はグループ作成をスキップし、そのグループに直接アセットを送信します
group と同時に指定することはできません。どちらか一方を使用してください
string
デフォルト:"default"
プロジェクト名デフォルト:default
string
デフォルト:"Image"
アセットタイプ選択肢:
  • Image - 画像アセット(デフォルト)
  • Video - 動画アセット
  • Audio - 音声アセット
デフォルト:Image
array
アセットリスト、1 回のリクエストで複数のアセットを送信できます
1 回の送信で最大 20 件まで
例:
string
単一アセット互換記法:アセット URL
assets 配列とどちらか一方のみ使用可能。単一アセットの送信に適しています
string
単一アセット互換記法:アセット名
assets 配列とどちらか一方のみ使用可能。単一アセットの送信に適しています

レスポンス

integer
レスポンスステータスコード。成功時は 200
object
タスク情報

使用例

例 1:バッチ送信(グループ自動作成)

group_id を指定しない場合、サーバーが AIGC タイプのアセットグループを自動作成してから送信します。

例 2:既存グループへのアセット追加

group_id を指定することでグループ作成をスキップして直接送信します。

例 3:単一アセット互換記法

アセットが 1 件のみの場合、トップレベルの urlname フィールドを直接使用できます。

審査結果の確認

アセット送信後は非同期審査タスクになります。タスク状態の取得 エンドポイントで進捗を確認してください:

全件承認

一部失敗

バッチ送信で 1 件でも審査に失敗した場合、タスク状態は failed になります。承認済みアセットは引き続き使用可能で、result.usable_assets に表示されます。
  • result.usable_assets[].asset_url は Seedance 2.0 の動画生成で直接使用できます
  • result.failed_assets 内のアセットはソースファイルを差し替えるか再送信が必要です
  • 単一アセットのタスクでも互換として result.asset_url が返されます

審査済みアセットの使用

asset://... URL を Seedance 2.0 動画生成 エンドポイントに直接渡してください:
サーバーが asset:// プレフィックスを検出すると、アセット審査を再度トリガーせず、直接生成タスクを送信します。