申請プロセス
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.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 の形式で生成パラメータを追加することができます（旧方式、弱い検証、誤って入力した場合は自動的にデフォルト値が使用されます）。完全なパラメータリストは以下の通りです：
推奨される方法：リクエストボディ内で対応するトップレベルフィールド（例：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 パラメータには 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）は reference_image、reference_audio および reference_video をサポートしています。自分の素材または許可された素材を使用して、キャラクター、主体、動作、カメラワーク、音声およびリズムの一貫性を保つことができます。
自分の素材または許可された実在のキャラクター素材のみをアップロードしてください。異なるモデルは実在の素材に対するサポート方法が異なります；リクエスト形式は変わらず、素材が要件を満たさない場合は明確なエラーが返されます。使用のポイント：
- Seedance 2.0 シリーズモデルのみが
reference_imageをサポートします；1.xモデルではfirst_frame/last_frame（画像から生成された動画の最初と最後のフレーム）を使用してください。 - 画像から生成された動画の最初のフレーム、画像から生成された動画の最初と最後のフレーム、全モーダル参考は三つの排他的なシーンです：
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；単一の長さは 2~15 秒、最大 3 条で合計長さは 15 秒を超えないこと；単一のサイズは 15 MB を超えないこと。長さの範囲を超えると、素材処理段階で失敗します。 - 参考動画（
video_url）素材の要件：形式mp4/mov；単一の長さは 2~15 秒、最大 3 条で合計長さは 15 秒を超えないこと。 - 参考画像は一人、正面、明瞭、遮蔽のない写真を使用することをお勧めします。顔が明瞭であればあるほど、類似度が高くなります。
例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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。