Seedance 2.0 のアクセス方法 | APIキーと初回生成

ByteDance が公開している一般向けアプリで、Seedance 2.0 を直接触らせてくれるものはありません。Seedance 2.0 のアクセス方法とは、実務上は、モデルを再販している窓口のどれかを選び、認証情報を手に入れ、正しい形のリクエストを送ることを意味します。このページはその道筋を最初から最後までたどり、最初のクリップの費用と、初回の呼び出しがたいてい失敗する4つの理由まで扱います。

どれも時間はかかりません。難しさの大半は、それぞれの窓口があなたに代わって黙って決めてしまう部分にあります。

モデルを載せている窓口

アクセスは3つの形でやってきます。どれを選ぶかで、何を制御できるかが決まります。

一般向け動画アプリはテキストボックスといくつかのプリセット、そしてクレジット残高を渡してくれます。キーもコードも不要。最初のクリップに最短でたどり着く経路であり、いちばん多くを隠す経路でもあります。尺の上限、解像度の引き下げ、ウォーターマークはモデルではなくアプリ側で適用され、どのバージョンが提供されているのかも分からないことがよくあります。

ホスト型 API はキーと生のリクエストを渡してくれます。モデルが公開しているパラメータはすべて届き、課金はクレジットではなく完成動画の秒単位で、何かが失敗したときには実際のエラーを読めます。その代わり、自分で HTTP を送る必要があります。

組み込み型の統合は、すでに課金している編集ツールやデザインツールの中にモデルを置きます。そのツールの中で生活しているなら便利ですが、パラメータの範囲はたいてい3つの中でいちばん狭いです。

ひととおり触ってみる以上のことをするなら、自分が何を手にしているのかを正直に教えてくれるのは API 経路です。

最初のリクエストの前に必要なもの

3つです。

選んだプラットフォームのアカウントと、そこに紐づいた支払い手段。プラットフォームのダッシュボードで発行し、Authorization: Bearer ヘッダーで送る API キー。そして、画像で生成を条件づけるつもりなら、その画像の公開されてアクセス可能な URL。メディア入力は公開された HTTP または HTTPS のリンクでなければなりません。データ URI はプラットフォーム全体で拒否されるので、手元のノートPCにあるファイルはまずどこかにアップロードする必要があります。

キーはベアラー認証情報です。持っている人は誰でもあなたの残高を使えるので、サーバー側に置き、ブラウザのバンドルには含めないでください。

ホスト型 API から Seedance 2.0 にアクセスする

呼び出しは、プラットフォームの動画生成エンドポイントへの JSON ボディ付き POST で、返ってくるのは動画ではなくタスク ID です。リクエスト全体を担うのは4つの項目です:

• モデル識別子。使いたいバージョンの公式ドキュメントからそのまま写す
• プロンプト。言葉によるムードボードではなく、ショットの記述
• 秒数での尺。2.0 では15を超えられない
• 解像度。480p、720p、1080p のいずれか

4K の設定はありません。この上限はどのホストでも同じで、このモデルで 4K を宣伝しているページはリリース前の主張を繰り返しています。

モデル文字列は記憶で打たずにコピーしてください。この系列の識別子は厳密にバージョン管理されていて、ネット上に出回っている古いコードサンプルには、もう解決しない文字列が書かれています。識別子が違うとタスクが作られる前にバリデーションで落ちるので費用はかかりませんが、誤字ではなくアクセス上の問題のように読めるエラーが返ってきます。

ポーリングと待ち時間

生成は非同期です。作成の呼び出しはタスク ID を持ってすぐに返り、ステータスが終了状態になるまでタスクのエンドポイントをポーリングします。ポーリングは無料なので、間隔を大きく空ける理由はありません。

2〜5分を見込んでください。20分経っても終わらないジョブは何かがおかしくなっていて、返金の扱いは他の失敗と同じです。

タスクが成功すると、レスポンスに完成ファイルの URL が入っています。ダウンロードしてください。ホスト側の結果 URL は恒久的なアーカイブではありません。

最初のクリップの費用

課金は完成動画の秒単位で、解像度によって単価が決まります。以下は Seedance 2.5 の公表単価で、秒単価がより安い 2.0 にとっては上限として機能します:

2.5 で 480p の5秒クリップはおよそ $0.59、2.0 ならそれ以下です。最初のレンダリングにかかる費用はその程度であるべきです。1080p ではなくそこから始めて、パイプラインが端から端まで動くことを確認し、プロンプトが決まってから解像度を上げてください。

失敗したジョブはコンテンツ審査による拒否も含めて全額返金されるので、うまくいかなかった実験が請求になることはありません。

初回の呼び出しが失敗する理由

大半は4つの原因で説明がつきます。

尺が15秒を超えている。 2.0 の固い上限で、バリデーションで弾かれます。もっと長いものが必要なら、狙うのは30秒まで走る Seedance 2.5 です。

ローカルまたは data: のメディア URL。 プラットフォーム全体で拒否されます。アップロードして公開リンクを渡してください。

廃止されたモデル文字列。 バリデーションエラーで、タスクは作られず、課金もありません。

安全性による拒否。エラー 80006 として返ります。どの段階が反応したかは示されないので、プロンプト、参照画像、生成された出力のいずれもが候補です。content_filter パラメータの既定値は true で、false にすると審査を無効化せずに制限のゆるいチャンネルに振り分けられます。その下では、実名の著名人、第三者の知的財産、違法なコンテンツがモデル自体でブロックされ、これはホスト側のどの設定でも変わりません。

よくある質問

コードを書かずに Seedance 2.0 にアクセスできますか？ はい。一般向けアプリか、編集ツールに組み込まれた統合から可能です。パラメータの制御と秒単位の課金を手放し、代わりにクレジット残高と他人のプリセットを受け取ることになります。

2.0 と 2.5 で別々のキーが必要ですか？ いいえ。両方を提供しているプラットフォームは、同じアカウントと同じキーの下で別々のモデル識別子として公開しています。バージョンの切り替えはたいてい文字列1つの変更です。

最初の動画ができるまでどれくらいかかりますか？ リクエストが受理されてから2〜5分です。作成の呼び出し自体はタスク ID を持って1秒以内に返るので、レスポンスに動画が入っていると思っている人はここで混乱します。

失敗した生成は課金されますか？ いいえ。失敗は拒否も含めて全額返金されます。終了したタスクのクレジットの数字を見て、確保分が戻ったことを確認してください。

ひとことでまとめると

Seedance 2.0 のアクセス方法は、3つの決定と1つのリクエストです。窓口を選ぶこと。一般向けアプリはバージョンも上限も隠し、API キーは両方を見せてくれると知ったうえで選びます。キーを取得してサーバー側に置き、参照画像は公開 URL でホストする。モデル文字列、プロンプト、15秒以下の尺、解像度を入れた POST を送り、2〜5分ポーリングする。最初の1本は 480p の5秒にしてください。数十セントで済みますし、失敗すれば返金されます。