Seedance 2.5 API クイックスタート

Seedance 2.5 の発表を読み、30 秒の生成クリップを中心に製品機能をスケッチし、いよいよコードを書きたいと思っていることでしょう。しかし、発表されたばかりのモデルで開発者が直面する壁にぶつかります。機能ページは公開されていますが、実際にアプリから呼び出せるエンドポイントはまったく別の問題です。

これが現状の正直なバージョンであり、それを尊重したクイックスタートです。Atlas Cloud は、Seedance 2.0 および 1.5 をすでに提供しているのと同じ統合エンドポイントで、Seedance 2.5 の Day-0 アクセスを約束する Seedance 2.5 ファミリーページを公開しました。執筆時点では、そのリストは「近日公開」とマークされており、Seedance 2.5 の Atlas Cloud 価格は公開されていません。実際には良いニュースです。今日、ライブの Seedance ティアに対して構築する統合は、2.5 のローンチ時に実行する統合と同じです。変更されるのはモデル文字列だけです。

したがって、このクイックスタートは 2 つの役割を果たします。今日、実際のエンドポイントから実際のビデオを取得し、アップグレードが 1 行の差分になるようにコードとプロンプトを構成します。

Seedance 2.5 で実際に提供されるもの

ByteDance の公式 Seedance 2.5 ページによると、これは、正確な参照制御と強力な編集機能を備えた 30 秒のストーリーテリング用に構築された次世代のオーディオビデオ共同生成モデルです。設計に値する具体的な主張は次のとおりです。

1 回の生成で最大 30 秒。より長く、より完全なストーリーテリングのために 2 回延長するオプションもあります。
よりスムーズで一貫性のある動き、よりリアルなビジュアル
より正確な参照ビデオ理解。単に動きを転送するだけでなく、意図、フレーミング、映画的言語を捉えます。
より広範なオーディオおよびビジュアル編集要求に対するより信頼性の高い編集
ホワイトモデル制御とグリーンバック編集、プロフェッショナルなカメラワークとパフォーマンスブロッキング。複雑な制作ワークフローを対象としています。

このリストにないものに注意してください。ベンチマークテーブル、解像度ラダー、参照アセット数はありません。その線に沿って見たものは、誰かのマーケティングの光沢であり、一次仕様書ではありません。上記の主張に基づいて構築してください。

ステップ 1: コンソールからキーを取得する

console.atlascloud.ai にサインインし、API キーを作成します。デポジット、最低契約、待機リストはありませんので、キーは従量課金制で即座に使用できます。1 つのキーで、テキスト、画像、ビデオにわたる 300 以上のモデルの全カタログを 1 つの請求アカウントでカバーします。これがこのクイックスタートにとって重要な部分です。今作成するキーは、Seedance 2.5 を呼び出すキーと同じです。

ソースではなく、環境変数として保存してください。ATLASCLOUD_API_KEY は適切な名前です。

ステップ 2: ビデオジョブを送信する

Atlas Cloud でのビデオ生成は、チャット補完ではなく、2 段階の非同期 REST コールです。ジョブを POST して予測 ID を取得し、レンダリングが終了するまでその ID をポーリングします。任意の HTTP クライアントで十分なので、ベンダー SDK をインストールしたり、新しい認証スキームを学習したりする必要はありません。作成したばかりのキーに対するベアラートークンです。

python
1import os, time, requests
2
3KEY  = os.environ["ATLASCLOUD_API_KEY"]
4BASE = "https://api.atlascloud.ai/api/v1/model"
5HED = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}
6
7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
8    "model": "bytedance/seedance-2.0/text-to-video",
9    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
10              "neon reflections on wet asphalt, slight lag on turns.",
11    "duration": 5,
12    "resolution": "720p",
13    "ratio": "adaptive",
14    "bitrate_mode": "standard",
15    "generate_audio": True,
16    "watermark": False,
17}).json()
18
19prediction_id = job["data"]["id"]

応答は {"code": 200, "data": {"id": "...", "status": "processing"}} として返されます。model がプレーンな文字列フィールドであることに注意してください。この詳細は、この記事のアップグレードストーリー全体であり、ステップ 6 で再び取り上げます。

ステップ 3: レンダリングが完了するまでポーリングする

5 秒のクリップは即座に返されるものではないため、レンダリングはブロッキングコールではなく、ライフサイクルを持つジョブとして扱います。status が最終値に達するまで予測エンドポイントをポーリングします。

python
1while True:
2    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
3    status = r["data"]["status"]
4    if status in ("completed", "succeeded", "failed"):
5        break
6    time.sleep(3)
7
8print(status, r["data"])   # on success the payload carries the output URL(s)

後でではなく、今すぐ組み込むべき 2 つのことがあります。スタックしたジョブがリクエストハンドラーをハングさせないように、ポーリングループに上限を設定し、ポーリングを開始する前に予測 ID を永続化して、クラッシュしたワーカーがレンダリングを 2 回支払うことなく再開できるようにします。どちらの習慣も 2.5 に変更なく引き継がれます。

機能が純粋なテキストではなく、参照画像または被写体参照から機能する場合、同じフローが異なるモデルバリアント、bytedance/seedance-2.0/image-to-video または bytedance/seedance-2.0/reference-to-video に適用されます。被写体参照アセットは uploadMedia を介して一度アップロードされ、画像フィールドで asset://<id> として渡されるため、繰り返し登場するキャラクターや製品は、呼び出しごとに再アップロードする必要はありません。

ステップ 4: ライブの Seedance ティアを選択し、1 秒あたりのコストを知る

Atlas Cloud は、出力期間の 1 秒あたりでビデオを請求します。これは、コードを書く前に頭の中で計算できる算術です。現在、3 つの Seedance ティアが稼働しています。

モデル	モデル ID	Atlas Cloud 価格	特記事項
Seedance 2.0	`bytedance/seedance-2.0/text-to-video`	$0.112/s	フラッグシップライブティア、即時キー、待機リストなし
Seedance 2.0 Fast	`bytedance/seedance-2.0-fast/text-to-video`	$0.09/s	同じファミリーの高速バリアント
Seedance 2.0 Mini	`bytedance/seedance-2.0-mini/text-to-video`	$0.056/s	最も安価なライブ Seedance 2.0 ティア、画像からビデオ、参照からビデオも対応
Seedance 1.5 Pro	`bytedance/seedance-v1.5-pro/text-to-video`	$0.047/s、または Fast バリアントで $0.018/s	ネイティブ同期オーディオ、多言語リップシンク、4 ～ 12 秒のクリップ

参考までに、同じキーで実行される他のビデオモデルも同様の範囲で動作します。Grok Imagine Video v1.5 は $0.080/s、Wan 2.7 は $0.100/s、Kling V3.0 Turbo は標準で $0.112、割引で $0.095、MiniMax H3 は $0.14/s です。

どのモデルを構築するかは、2.5 の機能が最終的に何をするかによって異なります。オーディオが出力の中核である場合、Seedance 1.5 Pro は、ネイティブ同期オーディオと多言語リップシンクをすでに備えているティアであるため、パイプラインは最初からオーディオトラックを処理することを学習します。プロンプト構造を反復処理し、実験あたりのコストを最小限に抑えたい場合は、Seedance 2.0 Mini が $0.056/s で明らかなサンドボックスです。プロダクショングレードの現世代レンダリングに最も近いものを望む場合は、Seedance 2.0 が $0.112/s で簡単な選択であり、スループットが品質の最後の増分よりも重要である場合は、Fast バリアントが $0.09/s です。

ステップ 5: 費用をかける前に Playground でライブ価格を確認する

最初の有料通話の前に、Atlas Cloud Playground でモデルを開きます。各モデルは、実行ボタンの横にライブのモデルごとの価格を表示します。これは、思っている以上に重要です。プロモーション割引は出たり入ったりしますが、実行ボタンの横の数字が実際に請求されるものです。Playground で 1 回生成を実行し、出力が機能に必要なものであることを確認してから、設定をコードに移植します。

出力あたりの秒数モデルは、予算の会話を些細なものにします。Seedance 2.0 Mini で 10 秒のクリップは 10 × $0.056 です。計算機も、トークン見積もりも、事後調整ステップもありません。

これは、ByteDance の一次チャネルが Seedance をどのように請求するかと対照的です。中国の Volcano Engine Ark と国際的な BytePlus ModelArk では、請求はトークンベースです。推定トークン消費量は、（入力ビデオ期間 + 出力ビデオ期間）× 出力幅 × 出力高さ × 出力フレームレート / 1024 で、トークン単価を掛けたもので、API 応答の usage.completion_tokens フィールドからの実際の使用量が権威となります。Seedance 2.0 シリーズと Seedance 2.5 では、入力にビデオが含まれる場合、最小トークン消費フロアが適用され、フロアは解像度、アスペクト比、出力期間によって異なります。ByteDance は、まさにこの理由で価格計算機と最小トークンテーブルを公開しています。

どちらのモデルも正当です。しかし、30 秒のレンダリングの予算を立てている場合、出力期間あたりの秒数は暗算であり、フロア付きトークンにはスプレッドシートが必要です。

ステップ 6: すでに 2.5 であるかのようにショットの説明を書く

これは、プロンプト作成がバージョン管理されていないため、クイックスタートのこの部分が完全に転送される部分です。2.5 の機能主張のうち 2 つは、今日の書き方を変えるはずです。

正確な参照制御。 ByteDance の主張は、2.5 が参照ビデオをその意図、フレーミング、映画的言語について読み取り、モーション転送を超えているということです。プロンプト作成の含意は、参照アセットがモーションテンプレートではなく、監督の指示書になるということです。したがって、被写体だけを説明するプロンプトを書くのをやめ、引き継ぎたい文法を命名し始めます。レンズの感触、フレーミング、カットのペース、カメラが被写体をリードするか追従するかなどです。「人物が歩いている、映画的」ではなく、「手持ち、被写体追従のミディアムショット、夜市を縫うように進む宅配便業者、濡れたアスファルトにネオンの反射、ターンでわずかな遅延」と書きます。

1 回の生成で 30 秒。 5 秒のクリップは 1 つのショットです。30 秒は構造を持つシーンであり、2.5 はその上に 2 回の延長をサポートしています。したがって、単一の静的な説明ではなく、ビート構造を持つショットの説明を書きます。確立するビート、変化（ターン、入場、公開）、そして解決です。カメラの動きとパフォーマンスブロッキングを明示的に命名します。これらはまさに 2.5 が目指している制御だからです。被写体がどこに立つか、どこに移動するか、移動中にカメラが何をするか。

どちらの習慣も、今すぐライブティアで報われます。どちらも 2.5 が報いる正確な習慣です。

ステップ 7: スワップを計画する

モデル識別子がリテラルではなく構成になるようにコードを構造化します。環境または構成から読み取られる 1 つの定数。

python
1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")

次に、ステップ 2 で文字列をハードコードした場所に SEEDANCE_MODEL を渡します。model は generateVideo ボディ内の単一の JSON 文字列フィールドであるため、2.5 のローンチ時のアップグレードは実際に 1 つの環境変数です。小さな変更の比喩ではなく、文字通り 1 つの値です。

今日、Seedance 2.5 識別子をハードコードしないでください。Atlas Cloud Seedance 2.5 モデル ID はまだ存在しないからです。新しいバリアントが時間とともに追加されるため、この記事を含む記事からコピーするのではなく、atlascloud.ai/models のカタログから正確なライブ ID を取得してください。2.5 が Day-0 コミットメントの下でリリースされた場合、あなたの側の作業は、その 1 つの変数と、実行ボタンの横の価格の再確認、および新しいリクエストパラメータの再確認です。30 秒のモデルで拡張サポートがある場合、2.0 ボディにはないフィールドを受け入れる可能性があります。

一方、Atlas Cloud のローンチ時ではなく、今日 Seedance 2.5 が必要な場合は、正直な答えは ByteDance の一次チャネルです。中国の Volcano Engine Ark と国際的な BytePlus ModelArk です。アグリゲーターの中には、同じプレローンチまたは Day-0 コミットメントの状態にあるものもあります。

FAQ

Q: 今すぐ Atlas Cloud で Seedance 2.5 を呼び出すことはできますか？ A: いいえ。Atlas Cloud の Seedance 2.5 ファミリーページは「近日公開」とマークされており、Seedance 2.0 および 1.5 をすでに提供しているのと同じ統合エンドポイントでの Day-0 アクセスが約束されています。まだモデル ID も価格も公開されていません。

Q: Atlas Cloud での Seedance の今日の費用はいくらですか？ A: Seedance 2.0 は $0.112/s、Seedance 2.0 Fast は $0.09/s、Seedance 2.0 Mini は $0.056/s、Seedance 1.5 Pro は $0.047/s、またはその Fast バリアントで $0.018/s です。請求は出力期間の 1 秒あたりで、ライブ価格は Playground の実行ボタンの横に表示されます。

Q: Atlas Cloud でビデオ用の特別な SDK が必要ですか？ A: いいえ。ビデオはプレーンな REST フローです。POST /api/v1/model/generateVideo でジョブを送信し、GET /api/v1/model/prediction/{id} でポーリングします。どちらも Atlas Cloud キーのベアラートークンで認証されます。任意の HTTP クライアントで動作します。ビデオはテキストカタログが使用する OpenAI 互換のチャットエンドポイントを通過しないため、chat.completions がクリップをレンダリングすることを期待しないでください。モデルごとのリクエストパラメータは atlascloud.ai/docs で文書化されています。

Q: 開始するためのデポジットや最低契約はありますか？ A: いいえ。Atlas Cloud は従量課金制で、デポジット、最低契約、待機リストはありません。console.atlascloud.ai からのキーはすぐに使用できます。

Q: 2.5 をターゲットにしている場合、どのライブティアでプロトタイプを作成すべきですか？ A: 安価なプロンプト反復には Seedance 2.0 Mini が $0.056/s、パイプラインがネイティブ同期オーディオトラックを処理する必要がある場合は Seedance 1.5 Pro、最も近い現世代のプロダクションレンダリングには Seedance 2.0 が $0.112/s です。

まとめ

Atlas Cloud は、Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini、Seedance 1.5 Pro を、1 つの API キーで、出力期間あたりの秒数課金、SOC II 認証、HIPAA 準拠、保存時および転送時の暗号化で今日実行しており、Seedance 2.5 がリリースされたときに、これらの同じ統合エンドポイントで提供するという Day-0 コミットメントを公開しています。

一覧に戻る