2026/09/12

Seedance 2.5画像からビデオへ：フレーム、入力と費用

Seedance 2.5画像からビデオへ：初期フレーム、開始・終了フレーム、参照画像を学習。有効なAPIフィールド、実人物入力、10秒のコストを確認。

Seedance 2.5画像からビデオへをreAPIで使用する場合、単一のモデルID doubao-seedance-2.5-faceを異なるジョブに応じて異なる画像フィールドで使用します。特定の構図から開始するべきクリップでは明示的な初期フレームを使用し、両方のエンドポイントが重要な場合は初期フレームと最終フレームを使用し、モデルが新しいシーンを構築する際に視覚的ガイダンスを利用したい場合は参照画像を使用します。^[1]

フレームの役割によって、提出するJSONが異なります。フレームの役割にはsize: "adaptive"が必要です。参照画像の入力では選択したアスペクト比が許可されます。画像を含むが参照ビデオなしの10秒720pリクエストの場合、9月12日の料金はクレジット切り上げ後$2.669です。Seedance 2.5プレイグラウンドとAPIドキュメントで利用可能なコントロールが公開されています。^[1]^[2]

要点

image_with_rolesをrole: "first_frame"で使用して、特定の視覚的開始フレームをリクエストします。sizeをadaptiveに設定します。^[1]
2番目のエンドポイントが必要な場合、last_frameエントリを1つ追加します。最終フレームには初期フレームが必要です。各役割を指定できるのは最大1回です。^[1]
参照画像にはimage_urlsを使用します。APIは最大30個まで受け入れますが、制限を満たす必要はありません。^[1]
実人物の参照画像はreAPIでサポートされており、自動的にレビューされます。モデレーション拒否によるタスク失敗は全額払い戻されます。^[2]
画像参照は請求対象のソース秒を追加しません。10秒の720p画像リクエストは9月12日の非ビデオ料金で2,669クレジットの費用がかかります。^[1]^[2]

Seedance 2.5画像からビデオへの入力形式を選択する

入力フィールドを選択する前に、画像が何を制御する必要があるかを決定します。開始フレームは初期構図を定義し、参照画像は人物、物体、または背景の外観を提供できます。同じソースファイルを使用しても、これらは異なる指示です。

目標	リクエストフィールド	アスペクト比	結果で検査する項目
特定の開始構図をアニメーション化する	`image_with_roles`と`first_frame`	`adaptive`	開始フレーム、リクエストされたモーション、および不要な背景変更
2つの指定された構図の間を移動する	`image_with_roles`と初期および最終ロール	`adaptive`	両方のエンドポイントとそれらの間の遷移
新しいシーンで1つ以上の視覚的参照を使用する	`image_urls`	受け入れられた`size`を選択	アイデンティティ、物体の外観、および各参照に割り当てられたロール

入力フィールドとアスペクト比の制約は、ドキュメント化されたAPI動作です。レビュー列は編集チェックリストであり、入力フィールドが完全な視覚的保存を保証するという約束ではありません。^[1]

単純な写真アニメーションの場合は、1つの明示的な初期フレームと1つの目立つアクションで開始します。目標が新しく説明された位置に2つの参照された人物を配置することである場合、代わりに参照画像で開始します。必要な制御の種類を判断する前に複数のソースファイルを追加すると、プロンプトも結果も解釈が難しくなります。

1つの明示的な初期フレームをアニメーション化する

明示的な初期フレームのリクエストはimage_with_rolesを使用します。以下のcURLの例では、パブリックサンプルとして既に利用可能な肖像画を使用します。それを自分の許可されたソース画像に置き換え、見たいモーションを記述します。

curl --fail-with-body https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.5-face",
    "prompt": "The adult turns her head slightly toward the camera and gives a small natural smile. Keep the framing, hairstyle, white top and background stable. One continuous shot, no camera movement.",
    "image_with_roles": [
      {
        "url": "https://file.deepytb.com/landing/qwen-image-2/playground-input.webp",
        "role": "first_frame"
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "size": "adaptive",
    "generate_audio": false
  }'

フレームが開始構図を提供するため、プロンプトはモーションに集中できます。どの被写体が動くか、どの方向に動くか、何が静止したままであるべきかを説明します。プロンプトの大部分を既に見えている詳細の説明に費やすことは避けてください。ただし、その詳細は特に保存することが重要な場合を除きます。

固定カメラの肖像の場合、頭や目の動きは、見えない場面の部分を明らかにする大きなカメラのオービットよりもシンプルな最初のテストです。製品写真の場合は、シルエット、ハンドル配置、ラベリング、反射を検査します。これらのチェックは出力を評価します。これらはモデルにそれらの詳細を保存させる設定ではありません。

送信はタスクIDを返します。そのタスクが完了するまでポーリングし、output.video_urlsを読みます。APIクイックスタートで完全な送信とポーリングの例が提供されています。^[1]

初期フレームと最終フレームを接続する

開始画像と終了画像の両方が重要な場合は、2つの明示的なロールを使用します。first_frameとlast_frameは、それぞれ最大1つまで指定できます。後者は単独で送信することはできません。size: "adaptive"を保持します。出力はフレーム入力の形状に従うためです。^[1]

{
  "image_with_roles": [
    {
      "url": "https://your-public-storage.example/start.png",
      "role": "first_frame"
    },
    {
      "url": "https://your-public-storage.example/end.png",
      "role": "last_frame"
    }
  ],
  "size": "adaptive"
}

これはモデル、プロンプト、期間、解像度と組み合わせるための部分的なペイロードです。2つのURLはプレースホルダーです。例を使用する前に、実際の画像をパブリックストレージにアップロードしてください。ローカルファイルパスまたは名前を変更した拡張子は、読み取り可能なメディアファイルの代わりにはなりません。

もっともらしい遷移を説明するエンドポイントを選択します。開始が座っている人を示し、終了がその人が立っているのを示す場合は、立つ行為を説明し、それに十分な時間を与えます。2つの画像が衣服、部屋のジオメトリ、カメラの位置も変更する場合、遷移ではより多くの変更を調整する必要があります。実際にはどの変更が必要かを決定し、その解釈を暗黙のままにしないでください。

エンドポイントと同じくらい慎重にクリップの中央もレビューします。開始と終了に一致することは、介入するモーションが跳躍、歪んだ手、または予期しないカットを含む場合は十分ではありません。遷移が改善する必要のある部分である場合、アクションを修正するか、スタイリスティックな形容詞をさらに追加する前にエンドポイントを閉じる方を選択してください。

各参照画像に1つのジョブを割り当てる

複数の画像によってガイドされた新しい構図の場合は、image_urlsを使用します。APIはドキュメント化されたファイルサイズ制限より下の最大30個の参照画像を受け入れます。画像はパブリックHTTP(S) URLを通じてアクセス可能である必要があります。base64データURIは受け入れられません。^[1]

{
  "model": "doubao-seedance-2.5-face",
  "prompt": "Use Image1 for the adult in white and Image2 for the adult in black. Place both in a quiet gallery. The adult in white waves once; the adult in black nods. Keep their hairstyles and outfits distinct. Fixed camera.",
  "image_urls": [
    "https://file.deepytb.com/landing/qwen-image-2/playground-input.webp",
    "https://file.deepytb.com/landing/grok-imagine-video-1-5/playground-input.png"
  ],
  "duration": 4,
  "resolution": "480p",
  "size": "16:9",
  "omni_reference_task_type": "reference",
  "generate_audio": false
}

最初のサンプルは長い髪と白いトップの1人の成人を示しています。2番目は短いボブと暗い服を着た1人の成人の3視点肖像です。後者を使用する場合は、そのパネルが1つのアイデンティティを描写していることを明示して、意図するシーンが明確になるようにしてください。20プロンプトライブラリには、2参照テストに使用された正確なより長いプロンプトとその生成結果が含まれています。

image_urlsとimage_with_rolesを1つのリクエストで組み合わせないでください。これらは相互に排他的です。また、reference_imageロールをimage_with_roles内の明示的なフレームロールとは別に保持してください。ドキュメントはこれらを異なるリクエスト形状として扱っています。^[1]

明示的なフレーム画像とともにvideo_urlsまたはaudio_urlsを追加すると、それらの画像の使用方法が変わります。リクエストはマルチモーダル参照ジョブになります。上記の厳密な初期/最終フレームワークフローに依存するのではなく、フレームを参照ガイダンスとして扱ってください。^[1]

参照セットに複数の被写体が含まれる場合、誰が何をするのかを明確にする箇所では、被写体の名前または視覚的ラベルを繰り返します。「白い服の大人がカップを持ち上げる」は、2人について段落を読んだ後「彼女がそれを持ち上げる」より曖昧ではありません。Image1とImage2のラベルを実際の入力順序と一致させてください。

実人物の参照をアップロードし、エラーを診断する

reAPIはSeedance 2.5の実人物参照画像とビデオをサポートしています。参照は生成前に自動レビューを通過し、拒否された素材はエラーで応答し全額払い戻されます。入力タイプのサポートは、すべての個別ファイルが受け入れられることを保証するものではありません。^[2]

使用する権利のある画像を使用し、提出前に被写体の意図した描写を確認してください。リクエストが失敗した場合、プロンプトを書き直す前にエラーを読んでください。アクセス不可のURL、無効なリクエストフィールド、およびモデレーション拒否には異なる対応が必要です。

エラー	最初に確認
ソースURLが読み取れない	直接メディアURLがサインインしたブラウザセッションなしで機能することを確認してください
リクエストが画像フィールドを拒否する	相互排他性と初期/最終フレームのロール規則を確認してください
アスペクト比エラー	明示的なフレームロールで`adaptive`を使用してください
サポートされていない形式	ファイル名だけでなく、実際のファイルエンコーディングを確認してください
モデレーション拒否	素材と意図されたコンテンツを確認してください。返されたエラーを検査してください

実人物参照エラーガイドは、より広いトラブルシューティングコンテキストを提供します。正確に受け入れられたファイル形式と検証規則については、現在の2.5ドキュメントを参照してください。^[1]

1つの画像と10秒の720pの費用

画像のみのリクエストは参照ビデオなしの料金を使用します。9月12日の時点で、その料金は720pで出力秒あたり$0.266824です。したがって、10秒はceil(0.266824 × 10 × 1000) = 2669クレジット（$2.669）の費用がかかります。^[2]

ソースビデオなしの画像リクエスト	出力期間	支払い合計
480p	4秒	475クレジット / $0.475
720p	10秒	2,669クレジット / $2.669
1080p	10秒	4,619クレジット / $4.619

これらの合計は正確にレンダリングされた料金を使用し、リクエスト全体をクレジットに切り上げます。画像参照は請求対象のソース秒を追加しません。video_urlsを追加する場合、請求計算は参照ビデオ期間とドキュメント化された最小ウィンドウを含めるように変わります。^[1]^[2]

入力モードを比較するとき、その区別を保持します。2つの画像を含むプロンプトは、この価格の質問に対して画像参照リクエストのままです。複数のソースアセットを持つだけでは、参照ビデオリクエストにはなりません。より広い選択のモデルについては、画像からビデオへのAPIガイドを参照してください。この記事は、2.5を選択した後のSeedance固有のフィールドの選択をカバーしています。

reAPI. Seedance 2.5 API — Parameters, Modes & Billing. 2026年9月12日にブラウザから取得。reapi.ai/docs/seedance-2-5。
reAPI. Seedance 2.5 rendered pricing and real-person-reference FAQ. 2026年9月12日にブラウザから取得。reapi.ai/models/seedance-2-5。

すべての記事