Seedance 2.5 Flash
Seedance 2.5 Flash APIリファレンス: 動画生成、フレームと参照素材、リクエスト例、タスクのポーリング、ダウンロード、料金。
テキスト、フレーム、参照素材から動画を生成するか、元のクリップを編集できます。モデルとPlayground。
タスクを作成する
APIキー設定でサーバーサイドキーを作成します。https://api.wanapi.app/v1/videosにPOSTを1回送信し、返されたidを保存します。
curl https://api.wanapi.app/v1/videos -H "Authorization: Bearer $WAN_API_KEY" -H "Content-Type: application/json" -d '{"model":"bytedance/seedance-2.5-flash","prompt":"A paper boat floats through a sunlit stream. Slow tracking shot.","resolution":"720p","aspectRatio":"16:9","duration":4,"generateAudio":true}'リクエストフィールド
model: "bytedance/seedance-2.5-flash"と空でないpromptを指定します。resolutionは480pまたは720p(デフォルト)に設定します。生成する動画の長さはdurationで4~30秒(デフォルトは5秒)です。無音で出力するにはgenerateAudio: falseを指定します。タスクごとの出力は1本で、フレームレートは24 fps固定です。
テキストや参照素材から動画を生成する場合は、固定の aspectRatio を使用します。16:9(デフォルト)、9:16、1:1、4:3、3:4 または 21:9 を指定できます。開始フレームと終了フレームには、開始フレーム用の image、または最初の first_frame と任意の最後の last_frame を含む frameImages を渡します。各フレーム項目には frameType と image URL が含まれます。フレームと編集では、適応型のフレーミングが使用されます。
参照画像または参照動画は、それぞれ type: "url"、url、mediaType を含む inputReferences に渡します。画像は最大10枚、動画は最大5本、音声クリップは最大5件です。音声 URL は providerOptions.bytedance.referenceAudio に渡します。1回のリクエストでは、開始・終了フレームと参照素材のどちらか一方を使用します。
編集するには、providerOptions.bytedance.omni_reference_task_type に edit を設定し、参照動画をちょうど1本指定して、duration を省略するか -1 に設定します。もう一方のタスクタイプ generate がデフォルトです。コンテンツフィルターはデフォルトで true です。API クライアントは providerOptions.bytedance.content_filter を false に設定できます。
メディア仕様
認証情報を含まない、一般公開されている HTTP(S) URL を使用してください。画像:JPEG、PNG または WebP、最大30 MB。画像と動画:各辺300~6000ピクセル、アスペクト比0.4~2.5。
動画:MP4 または MOV、最大200 MB、24~60 fps、409600~8295044ピクセル。参照素材の長さは2~30秒、編集ソースの場合は4~30秒です。動画の合計時間は最大30秒です。
音声:MP3 または WAV、最大15 MB、クリップごとに2~30秒、合計で最大30秒です。
ポーリングとダウンロード
同じ API キーを使って GET https://api.wanapi.app/v1/videos/{id} をポーリングします。ステータスが queued または in_progress のタスクはポーリングを続けてください。completed になったら videos[0].url をダウンロードします。相対 URL は API ホストを基準に解決し、そのホストで認証してください。署名付きメディア URL はそのまま使用します。failed の場合は error.message を確認してください。ポーリングに失敗した場合は、同じタスク ID で再試行します。
料金
| 解像度 | 動画入力なし | 動画入力あり |
|---|---|---|
| 480p | $0.096 | $0.06 |
| 720p | $0.192 | $0.12 |
音声は料金に含まれています。参照用および編集時の計算については、課金対象秒数のガイドをご覧ください。