申請プロセス
SeeDance Videos Generation API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全なドキュメント：SeeDance Videos Generation API →
基本使用
まず、基本的な使用方法を理解します。これは、プロンプトcontent.text、タイプ content.type=text、およびモデル model を入力することで、処理された結果を得ることができます。具体的な内容は以下の通りです：
accept：受け取りたいレスポンスの形式。ここではapplication/json、つまり JSON 形式を記入します。authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
model：生成する動画のモデル。- Seedance 1.x シリーズ：
doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015、doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428。 - Seedance 2.0 シリーズ（顔/キャラクター参照などのマルチモーダル入力をサポート）：
doubao-seedance-2-0-260128（標準）、doubao-seedance-2-0-fast-260128（高速）、doubao-seedance-2-0-mini-260615（軽量）。詳細は下記「顔とキャラクター参照（Seedance 2.0）」のセクションを参照してください。
- Seedance 1.x シリーズ：
content：入力内容の配列、typeはtext（プロンプト）、image_url（参照画像）、audio_url（参照音声、2.0）、video_url（参照動画、2.0）であることができます。画像はroleを通じて用途を指定できます：first_frame（初フレーム）/last_frame（終フレーム）/reference_image（顔/キャラクター/主体参照）。resolution：出力解像度、選択肢は480p/720p/1080p（2.0 標準モデルは4kもサポート；2.0 のfast/miniは最大720p）。ratio：アスペクト比、選択肢は16:9/4:3/1:1/3:4/9:16/21:9/adaptive。duration：動画の長さ（秒）、1.x の範囲は 2–12、2.0 の範囲は 2–15。seed：ランダムシード、整数、-1 から 4294967295。camerafixed：カメラを固定するかどうか、true/false。watermark：ウォーターマークを追加するかどうか、true/false。generate_audio：音声付き動画を生成するかどうか、true/false、のみdoubao-seedance-1-5-pro-251215がサポート。return_last_frame：結果に動画の最後のフレーム画像の URL を返すかどうか。execution_expires_after：タスクのタイムアウト時間（秒）、範囲は 3600–259200。callback_url：非同期コールバックアドレス、設定後 API はすぐにtask_idを返し、タスクが完了した際に結果をそのアドレスに POST します。async：オプション、trueに設定するとインターフェースはすぐにtask_idを返し、callback_urlを提供する必要はなく、その後対応するタスククエリインターフェースを通じて結果をポーリングして取得します。
success、この時点での動画生成タスクの状態。task_id、この時点での動画生成タスクの ID。trace_id、この時点での動画生成トラッキング ID。data、この時点での動画生成タスクの結果リスト。task_id、この時点での動画生成タスクのサーバー側 ID。video_url、この時点での動画生成タスクの動画リンク。status、この時点での動画生成タスクの状態。model、生成動画に使用されたモデル。
data の動画リンクアドレスに基づいて生成された SeeDance 動画を取得するだけです。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：
インラインパラメータ説明
content[].text プロンプトの末尾に、--parameter value の形式で生成パラメータを追加して渡すことができます（旧方式、弱い検証、誤って記入した場合は自動的にデフォルト値が使用されます）。完全なパラメータリストは以下の通りです：
推奨される方法：リクエストボディ内で対応するトップレベルフィールド（例：resolution、ratioなど）を直接使用し、強い検証モードを適用します。パラメータに誤りがある場合は明確なエラーメッセージが返され、問題の特定が容易になります。
音声付き動画の生成
doubao-seedance-1-5-pro-251215 は generate_audio パラメータを使用して音声付きの動画を生成することをサポートしています：
画像から動画の最初のフレーム
画像から動画を生成するタスクを行いたい場合、まずcontent パラメータには type が image_url の項目を含める必要があります。image_url フィールドはオブジェクト形式でなければなりません：{"url": "https://..."} または Base64 形式 {"url": "data:image/png;base64,..."}。
注意：対応するコード：image_urlは文字列形式（例："image_url": "https://..."）で直接渡すことはできず、オブジェクト形式"image_url": {"url": "https://..."}を使用する必要があります。そうしないと 400 エラーが返されます。
画像から動画の最初と最後のフレーム
画像から動画の最初と最後のフレームを生成したい場合、まずcontent パラメータには type が image_url の項目を渡し、それぞれの role を first_frame と last_frame に設定することで、以下の内容を指定できます：
- role：最初のフレームまたは最後のフレームを指定します。
- image_url
- url 画像リンク
同時に
contentにはtextタイプを入力してプロンプトのヒントを提供する必要があります。
- url 画像リンク
同時に
顔とキャラクターの参考（Seedance 2.0）
Seedance 2.0 シリーズ（doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615）は「実在の人物 / キャラクター」の参考素材を渡すことをサポートしています：content に type が image_url、role が reference_image の項目を追加し、人物の写真を参考として使用します。モデルは生成された動画内でその人物の外見的特徴を保持し、同じ人物を「新しいシーン、動作、またはショット」に配置します。
📌 実在の人物の写真はプラットフォームによって自動的に基盤素材として登録され、その後生成に使用されます。このプロセスは呼び出し側にとって完全に透明です：リクエストとレスポンスの形式は変わらず、追加のパラメータは不要で、最初の生成時に素材処理に数秒余分にかかります。使用の要点：
- Seedance 2.0 シリーズモデルのみが
reference_imageをサポートします；1.x モデルではfirst_frame/last_frame（画像から動画の最初と最後のフレーム）を使用してください。 reference_imageはfirst_frame/last_frameと混用できず、どちらか一方のみを選択する必要があります。- マルチモーダル参照の数の上限：
image_urlは最大 9 枚；2.0 ではaudio_url（roleはreference_audio、最大 3 件）およびvideo_url（roleはreference_video、最大 3 件）もサポートされています。 - 参考画像は一人、正面、鮮明、遮蔽なしの写真を使用することをお勧めします。顔が鮮明であればあるほど、類似度が高くなります。
例1：人物の外見を保持したクローズアップ
顔写真を渡し、その人物がカメラに向かって微笑み手を振るようにします。対応するコード：例2：同じ人物を新しいシーンに配置
reference_image の強力な点は：人物のアイデンティティを保持しつつ、シーン、服装、動作は完全にプロンプトによって決定されることです。以下は同じ顔写真を使用し、その人物がベージュのコートを着て秋の公園を歩く様子です：
💡 人物が写真の構図を正確に再現するようにしたい場合（「異なるシーンの同じ人物」ではなく）、first_frame（画像から動画の最初のフレーム）を使用して、この写真から動画が動き始めるようにしてください。
非同期コールバック
SeeDance Videos Generation API の生成時間は長いため（約 1-2 分）、callback_url フィールドを使用して非同期モードを利用することで、HTTP 接続が長時間占有されるのを避けることができます。
全体の流れ：クライアントがリクエストを発行する際に callback_url を指定し、API はすぐに task_id を含むレスポンスを返します；タスクが完了すると、プラットフォームは生成結果を POST JSON 形式で callback_url に送信し、結果にも task_id が含まれているため、関連付けが可能です。
callback_url にプッシュする内容は以下の通りです：
task_id フィールドはリクエスト時に返されたものと一致し、このフィールドを通じてタスクの関連付けが可能です。
エラーハンドリング
API を呼び出す際にエラーが発生した場合、API は対応するエラーコードとメッセージを返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが欠落または無効である可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効である可能性があります。401 invalid_token：未認証、無効または欠落した認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えています。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。