Seedance 2.0 API

BytePlus ModelArk上の公式Seedance 2.0 APIフローを理解しましょう。タスク作成、ステータス取得、入力、料金、そしてLumiYingを使う方が簡単なケースまで整理します。

概要

Seedance 2.0 APIでできること

Seedance 2.0はByteDanceのマルチモーダル動画生成モデルです。BytePlus ModelArkでは非同期の動画生成ワークフローとして提供され、タスクを作成し、タスク結果を取得し、生成タスクをキューやプロダクトパイプラインの一部として管理します。

目的がインフラ構築ではなく制作なら、LumiYingはSeedance 2.0と他の動画・画像モデルを1つのクレジット残高で利用できるようにします。APIキーやリクエストスキーマを管理せずに出力を比較できます。

APIフロー

公式のタスクベースワークフロー

ModelArkの動画生成は非同期タスクを中心に設計されています。タスク作成、ポーリング、結果保存、キュー管理を前提に実装します。

動画生成タスクを作成

ModelArkの動画生成APIに、モデル、プロンプト、参照素材、出力設定を送信します。

非同期生成ジョブの開始点です。

タスクステータスを取得

成功または失敗するまでタスクをポーリングし、レスポンスから出力動画情報を読み取ります。

可能な限り、ブロッキングUIの外で処理してください。

タスクを一覧・キャンセル・削除

本番キュー、リトライ処理、クリーンアップ、運用ダッシュボードでタスク管理エンドポイントを使います。

単発テストを超えて運用する段階で役立ちます。

Dreamina-Seedance-2.0
品質優先の生成
720p階層では、動画入力ありで$4.3/M tokens、動画入力なしで$7/M tokensから公式リソースパック料金が始まります。
Dreamina-Seedance-2.0 fast
低遅延のテストと本番利用
720p階層では、動画入力ありで$3.3/M tokens、動画入力なしで$5.6/M tokensから公式リソースパック料金が始まります。
入力

入力とパラメータ

正確なスキーマはモデルバージョンや公式リリースにより変わる可能性があります。ここでは実装計画用メモとして扱い、フィールド名と制限はModelArkで確認してください。

テキストプロンプト

  • すべての生成モードで必要です。
  • アクション、カメラ、被写体、照明、音声方向を明確に書きます。
  • 会話は引用符で囲むと、音声と口の動きを合わせやすくなります。

画像

  • 開始フレーム、終了フレーム、キャラクター参照、スタイル参照として使えます。
  • APIがアクセスできる場所にメディアをホストし、プロバイダーのスキーマで必要なURLまたはファイル参照を渡します。
  • 形式、サイズ、枚数制限を固定する前に、最新の公式スキーマを確認してください。

動画

  • モーション、カメラ言語、振り付け、テンポ、編集・延長ワークフローの参照に使えます。
  • 短く焦点の絞られたクリップほど、明確なモーション目標になります。
  • 本番利用前に、ModelArkで受け付ける形式、尺制限、アップロード要件を確認してください。

音声

  • リズム、音楽同期、話し方、サウンド方向の参照に使えます。
  • 標準入力ではなく、必要な制作シーンで使う任意の参照として扱います。
  • 公式APIドキュメントで最新の尺と形式要件を確認してください。
モデル
品質、遅延、コスト要件に合うSeedance 2.0モデルバージョンを選びます。
プロンプト
被写体、動作、カメラ移動、照明、スタイル、会話や音声方向を説明します。
参照素材
本人性、動き、構図、タイミングを明確にする場合のみ、画像、動画、音声を添付します。
出力設定
現在の公式スキーマに従って、尺、アスペクト比、解像度、シードを設定します。
料金
BytePlus ModelArkはトークン/リソースパックルールでSeedance 2.0を課金します。LumiYingはノーコード制作向けに利用量をクレジットへ変換します。
タスクライフサイクル
タスクを作成し、ステータスを取得し、生成完了後に最終出力URLとメタデータを保存します。
実装メモ

実装時の注意点

公式ドキュメントを正とする

モデルID、スキーマ、制限、料金は変わる可能性があります。統合を出荷する前にBytePlus ModelArkで確認してください。

APIキーを保護する

APIキーはサーバー側に保持し、ブラウザコード、ログ、クライアント側環境変数へ露出させないでください。

キュー化したリクエストを優先する

動画生成には時間がかかります。ユーザーセッションをブロックするより、キュー、ステータスポーリング、Webhookの方が適しています。

短いテストから始める

まず4〜5秒のテストでスタイルと動きを固定し、その後長い出力にコストを使います。

ノーコード利用にはLumiYingを使う

独自統合が不要なら、LumiYingでSeedance 2.0と他モデルを1つのクレジットベースのワークスペースから利用できます。

参照元

使用したAPIリファレンス

料金やスキーマは変更される可能性があります。本番統合に進む前に、公式ModelArkドキュメントを確認してください。

FAQ

Seedance 2.0 API FAQ

Seedance 2.0 APIは現在利用できますか?

はい。BytePlus ModelArkは、タスク作成とタスク取得を含むSeedance 2.0動画生成APIドキュメントを公開しています。LumiYingでは、独自API統合を管理せずにSeedance 2.0を使えるノーコードワークスペースを提供します。

公式APIワークフローはどのようなものですか?

公式ModelArkワークフローはタスクベースです。動画生成タスクを作成し、タスクステータスを取得し、必要に応じて一覧、キャンセル、削除で生成タスクを管理します。

Seedance 2.0はどの入力を使えますか?

Seedance 2.0はテキストプロンプトを扱い、選択したワークフローと現在のModelArkスキーマに応じて画像、動画、音声参照も使えます。特定の制限やファイル形式に依存する前に公式ドキュメントを確認してください。

API料金はどのように計算されますか?

BytePlus ModelArkはDreamina-Seedance-2.0とDreamina-Seedance-2.0 fast向けにトークンベースのリソースパック料金を掲載しています。LumiYingはクレジット制を採用しているため、別々のAPIアカウントを用意せずにSeedance 2.0と他の動画・画像モデルを試せます。

LumiYingは独自の公開Seedance 2.0 APIを提供していますか?

このガイドは、現在のSeedance 2.0モデルAPIオプションとLumiYingワークスペース利用に焦点を当てています。LumiYingで自動化や統合が必要な場合は、アカウントからサポートへお問い合わせください。

APIを構築する前にSeedance 2.0を試す

独自統合に進む前に、LumiYingでプロンプト、参照素材、モデル選択をテストできます。