Skip to main content
このページは コードパス に焦点を当てています。ローカル画像を asset:// アセットID に変換し、それを参照してキャラクターの一貫性を保った動画を生成します。1本のスクリプトで、最初から最後まで完結します。エンドポイントごとのドキュメントとノーコードの Web UI については Asset Library をご覧ください。生成エンドポイントの完全なパラメータ一覧については Video Generation API をご覧ください。

アセット参照が必要な場合

キャラクターの一貫性がある動画を生成する場合、Seedance 2.0 は写実的な人間の顔を含む参照画像を直接受け付けません(ディープフェイク対策フィルタリング)。まずポートレートを信頼済みアセットとして取り込み、asset://xxx のアセット ID を取得してから、生成リクエストでそれを参照する必要があります。これにより、エピソードやショットをまたいでキャラクターの顔と服装の一貫性を保てます。まずは自分のケースを確認してください。

前提条件

2つの異なるキーを混同しないでください:
  • Asset Library KEY (icover.ai の Settings → Asset Library KEY で作成、sk-...): アセットのアップロード / 取り込み / 照会に使用します。詳しくは Asset Library ページの Step 0 を参照してください。
  • APIYI SeeDance2 token (api.apiyi.com で作成、sk-...SeeDance2 グループを有効化): 動画生成エンドポイント用です。

パイプラインの概要

ローカル画像 → 1) presign して直接アップロード用URLを取得し、PUT してファイルを公開URLに変換する → 2) アセットを取り込んでアセットIDを取得する → 3) Active までポーリングする(画像1枚あたり約13秒) → 4) 生成リクエストで asset://<Id> を参照し、プロンプト内では「Image 1」として扱う → 5) タスクを succeeded までポーリングする → 6) content.video_url をダウンロードする(署名付きリンクは24時間で期限切れになります — すぐに保存してください)。 すでに公開画像URLがある場合は、ステップ1をスキップしてください。アセットIDは永続的です — 1回取り込めば、ずっと参照できます。

完全なコード

プロンプトではアセットを「Image 1」「Image 2」と表記してください(content 配列内の順序に合わせます)— プロンプトに生のアセット ID を書かないでください

複数アセットを使った高度な利用

  • 複数の参照画像: 複数の image_url 項目を content に入れ(0〜9枚、各項目に role: "reference_image" 付き)、「画像 1」「画像 2」のように順番に参照します。1人のキャラクターでは、全身の正面ショットとニュートラルな正面顔のクローズアップを併用すると、最も一貫性が高くなります。
  • ソースの混在: asset:// ID、公開URL、Base64(data:image/png;base64,...)を同じ content 配列に混在できます。写実的な顔を含む画像だけは asset:// を経由する必要があります。
  • 参照動画 / 音声: 0〜3個の video_url 項目(role: "reference_video")と 0〜3個の audio_url 項目(role: "reference_audio")も追加できます。画像または動画は少なくとも1つ必要で、音声は画像または動画と一緒に送信する必要があります。
  • 実在人物アセット: まず 完全自動の実在人物認証フロー を実行してください — 演者がライブネス認証を完了すると、専用の実在人物アセットグループ GroupId が付与されます。取り込み時には groupId として渡してください。生成側のコードはこのページと同じです。

よくあるエラー

関連ページ

Seedance 2.0 の概要

モデル選択、料金、解像度表、よくある質問

Video Generation API

完全なパラメータ表、4つの生成モード、レスポンス形式

Asset Library

すべてのアセットライブラリエンドポイント、ノーコードのWeb UI、本人確認