申請フロー
SeeDance Videos Generation API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、控えておいてください。
まだログインまたは登録していない場合は、自動的にログインページへ移動し、登録とログインを促されます。完了後は自動的に現在のページに戻ります。
1つの API Token でプラットフォーム上のすべてのサービスを呼び出すことができ、サービスごとに個別申請する必要はありません。 初回申請時には無料クレジットが付与され、無料で体験できます。クレジットが不足した場合は コンソール で共通残高をチャージできます。
📘 完全なドキュメント：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.5：
doubao-seedance-2-5-260628。最長30秒、純粋な音声参照、より多くの素材、動画編集および延長をサポートします。
- Seedance 1.x シリーズ：
content：入力コンテンツ配列。typeはtext（プロンプト）、image_url（参照画像）、audio_url（参照音声）、video_url（参照動画）にできます。画像はroleにより用途を指定できます：first_frame（最初のフレーム）/last_frame（最後のフレーム）/reference_image（キャラクター / 主体参照）。resolution：出力解像度。480p/720p/1080p/4kから選択可能です。2.5 は 480p、720p、1080p をサポートし、2.0 Fast/Mini は 480p、720p をサポートし、2.0 Standard は最大 4k をサポートします。ratio：アスペクト比。16:9/4:3/1:1/3:4/9:16/21:9/adaptiveから選択可能です。duration：動画の長さ（秒、整数）。1.0 シリーズは 2～12、1.5 Pro は 4～12、2.0 シリーズは 4～15、2.5 は 4～30 です。1.5/2.x は-1（自動長さ）をサポートします。seed：ランダムシード。整数、-1～4294967295。camerafixed：カメラを固定するかどうか。true/false。watermark：ウォーターマークを追加するかどうか。true/false。generate_audio：音声付き動画を生成するかどうか。true/false。Seedance 1.5 Pro および 2.x シリーズでサポートされます。return_last_frame：結果内で動画の最後のフレーム画像 URL を返すかどうか。omni_reference_task_type：2.5 のみ。auto/reference/edit/extend。output_format：2.5 のみ。mp4/mov、デフォルトはmp4。tools：2.5 のみ。現在はweb_searchのインターネット検索ツールをサポートしており、結果数、キーワード数、検索ソースを制限できます。priority：2.5 で選択可能なタスク優先度。整数 0～9、デフォルトは 0。safety_identifier：最大64文字の安定した匿名エンドユーザー識別子。ハッシュまたは内部匿名 ID を使用し、氏名、メールアドレス、電話番号は渡さないでください。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 の形式を追加することで生成パラメータを渡すことができます（旧方式、弱い検証、入力に誤りがある場合は自動的にデフォルト値が使用されます）。完全なパラメータ一覧は以下のとおりです：
推奨方法：Request Body 内で対応するトップレベルフィールド（resolution、ratioなど）を直接使用してください。これは強い検証モードであり、パラメータ入力に誤りがある場合は明確なエラーメッセージが返されるため、問題の切り分けがより容易になります。
音声付き動画の生成
Seedance 1.5 Pro および 2.x シリーズは、generate_audio パラメータにより音声付き動画の生成をサポートしています：
Seedance 2.5 全モーダル生成、編集、延長
doubao-seedance-2-5-260628 は 480p / 720p / 1080p、4～30 秒または自動長をサポートし、素材の上限を 30 枚の参照画像、10 本の参照動画、10 本の参照音声（合計最大 50 個）まで引き上げています。2.5 は参照音声のみの送信もサポートしており、画像または動画を同時に提供する必要はなくなりました。
通常の全モーダル生成では omni_reference_task_type を省略するか、auto に設定するか、明示的に reference に設定できます。動画の編集および延長では、必ず reference_video を渡す必要があります：
reference：少なくとも 1 つのreference_image、reference_videoまたはreference_audioを渡します；2.5 は参照音声のみの送信をサポートしています。edit：必ずratio: adaptiveとduration: -1を使用します；出力時間は実際の結果に応じて課金されます。extend：必ずratio: adaptiveを使用します；durationは 4～30 または-1にできます。auto：モデルがプロンプトと素材に基づいて、生成、編集、または延長を自動選択します。- タスクタイプが素材またはプロンプトと一致しない場合、タスクは失敗し、特定可能なパラメータエラーが返されます；上記の制約に従って調整した後、再送信してください。
画像から動画の開始フレーム
画像から動画へのタスクを行いたい場合、まずcontent パラメータには type が image_url の項目を含める必要があり、image_url フィールドはオブジェクト形式でなければなりません：{"url": "https://..."} または Base64 形式 {"url": "data:image/png;base64,..."}。
注意：対応するコード：image_urlは文字列形式を直接渡すことをサポートしていません（例："image_url": "https://cdn.acedata.cloud/e724d7f13d.png"）。必ずオブジェクト形式"image_url": {"url": "https://..."}を使用する必要があり、そうでない場合は 400 エラーが返されます。
画像から動画の開始・終了フレーム
画像から動画の開始・終了フレームを指定したい場合、まずパラメータcontent にタイプ image_url を渡し、それぞれ role を first_frame と last_frame に設定することで、以下の内容を指定できます：
- role：開始フレームまたは終了フレームを指定します。
- image_url
- url 画像リンク
同時に、
contentには prompt プロンプトとしてタイプ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）は reference_image、reference_audio、および reference_video をサポートしています。所有している、または使用許諾を得た素材を使用して、キャラクター、被写体、動き、カメラワーク、音声、リズムの一貫性を維持できます。
所有している、または使用許諾を得た実在人物およびキャラクターの素材のみをアップロードしてください。実在人物の素材に対するサポート方法はモデルごとに異なります。リクエスト形式は変わりませんが、素材が要件を満たさない場合は明確なエラーが返されます。使用上のポイント：
reference_imageをサポートするのは Seedance 2.0 シリーズモデルのみです。1.x モデルではfirst_frame/last_frame（画像から動画への生成における開始・終了フレーム）を使用してください。- 画像から動画への生成の開始フレーム、画像から動画への生成の開始・終了フレーム、全モダリティ参照は、3つの相互排他的なシナリオです：
first_frame/last_frameはreference_image/reference_video/reference_audioと併用できません。 - 全モダリティ参照で開始・終了フレームを指定したい場合は、画像を
reference_imageとして指定し、プロンプトに「画像1を開始フレームとして使用」または「画像2を終了フレームとして使用」と明記してください。開始・終了フレームを厳密に固定する必要がある場合は、first_frame/last_frameのみを使用してください。 - マルチモーダル参照の数の上限：
image_urlは最大 9 枚です。2.0 ではaudio_url（roleはreference_audio、最大3件）およびvideo_url（roleはreference_video、最大3件）もサポートします。 - 参照音声（
audio_url）の素材要件：形式はwav/mp3；1件あたりの長さは2～15秒、最大3件かつ合計時間は15秒を超えない；1件あたり15 MB以下。時間範囲を超えると、素材処理段階で失敗します。 - 参照動画（
video_url）の素材要件：形式はmp4/mov；1件あたりの長さは2～15秒、最大3件かつ合計時間は15秒を超えない。 - 参照画像には、1人、正面顔、鮮明、遮蔽物なしの写真を使用することを推奨します。顔が鮮明であるほど、類似度が高くなります。
例1：人物の顔立ちを維持したクローズアップ
顔写真を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：内部サーバーエラーです。サーバーで問題が発生しました。