申請プロセス
APIを使用するには、まず SeeDance Videos Generation API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように：
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。
初回申請時には無料のクレジットが付与され、このAPIを無料で使用できます。
基本使用
まず、基本的な使用方法を理解します。これは、プロンプトcontent.text、タイプ content.type=text、およびモデル model を入力することで、処理された結果を得ることができます。具体的な内容は以下の通りです：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまりJSON形式を記入します。authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
model：生成する動画のモデル。選択可能な値：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。content：入力内容の配列。typeはtextまたはimage_urlです。resolution：出力解像度。選択肢は480p/720p/1080p。ratio：アスペクト比。選択肢は16:9/4:3/1:1/3:4/9:16/21:9/adaptive。duration：動画の長さ（秒）。範囲は 2–12。seed：ランダムシード。整数、-1 から 4294967295。camerafixed：カメラを固定するかどうか。true/false。watermark：ウォーターマークを追加するかどうか。true/false。generate_audio：音声付き動画を生成するかどうか。true/false、のみdoubao-seedance-1-5-pro-251215がサポート。service_tier：推論モード。default（オンライン）またはflex（オフライン、価格はオンラインの50%）。return_last_frame：結果に動画の最後のフレーム画像のURLを返すかどうか。execution_expires_after：タスクのタイムアウト時間（秒）。範囲は 3600–259200。callback_url：非同期コールバックアドレス。設定後、APIはすぐにtask_idを返し、タスクが完了した際に結果をそのアドレスにPOSTします。
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 には image_url タイプを渡し、それぞれ role を first_frame と last_frame に設定することで、以下の内容を指定できます：
- role：最初のフレームまたは最後のフレームを指定します。
- image_url
- url 画像リンク
同時に
contentにはtextタイプを入力してプロンプトのヒントを提供する必要があります。
- url 画像リンク
同時に
非同期コールバック
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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。