https://api.krea.ai のベース URL を使用します。
利用可能な Seedance API モデル
これらのモデルは、テキストから動画、開始フレームと終了フレーム、リファレンスメディア、ネイティブ音声に対応しています。Seedance 2.5 はドラフトモードにも対応しています。これは低コストの 480p プレビューで、後からフル品質でレンダリングできます。各モデルの最新のリクエストスキーマは API リファレンス を参照してください。ジョブを送信する前に API 料金 ↗ を確認してください。料金はモデルと生成設定によって異なります。
Krea の Seedance 2.0 および 2.0 Fast エンドポイントには、ベースモデルに加えて、オプションの Krea プロンプト強化とアップスケーリングが含まれます。Seedance 2.5 にはオプションの Krea プロンプト強化が含まれます。
reference_videos を使用した Seedance 2.5 の動画編集リクエストでは、出力の長さとアスペクト比はソース動画に基づいて決まり、duration と aspect_ratio は無視されます。Seedance API キーを取得する
API キーと請求 の手順に従って Krea API トークンを作成し、API 残高を追加してください。トークンはサーバー上のKREA_API_KEY 環境変数に保存します。Authorization: Bearer $KREA_API_KEY として送信し、ブラウザのコードには決して公開しないでください。
Krea アプリのコンピュートと API 残高は別々に管理されます。Krea API を通じた Seedance リクエストには、ワークスペースの API 残高が使用されます。
動画を生成する
テキストから動画を生成するには、Seedance 2.5 エンドポイントにプロンプトを送信します。以下の例では、5 秒間、720p の横長動画をリクエストします。npm install @krea-ai/sdk でインストールします。REST リクエストは完成した動画ではなく job_id を返します。status が completed になるまで 2〜5 秒ごとに GET /jobs/{job_id} をポーリングし、完了したら result.urls[0] から動画の URL を取得します。failed または cancelled になった場合はポーリングを停止してください。SDK の jobs.wait メソッドはポーリングを自動で処理します。
cURL
画像をアニメーション化する
Seedance で画像から動画を生成するには、同じエンドポイントを使用し、リクエストにstart_image を追加します。公開アクセス可能な画像 URL、アップロード済みアセットの URL、または base64 データ URI を渡してください。
start_image はご自身の画像 URL に置き換えてください。最終フレームを制御するには end_image を追加します。リファレンスに基づく生成では、選択したモデルの API スキーマ に従って reference_images、reference_videos、reference_audios を使用します。
ドラフトモードでショットをプレビューする
Seedance 2.5 のドラフトモードは、リクエストの 480p プレビューを高速にレンダリングし、480p の料金で課金します。フルレンダリングの料金を支払う前に、構図、動き、プロンプトの意図を確認するために使用します。ドラフトが問題なければ、そのジョブ ID を同じエンドポイントに送り返します。モデルは新しいショットを始めるのではなく、同じショットをフル品質で再生成します。1
ドラフトを生成する
通常の Seedance 2.5 リクエストに 返された
"draft": true を追加します。ドラフトは常に 480p でレンダリングされるため、draft と一緒に送った resolution は無視されます。cURL
job_id を status が completed になるまでポーリングし、480p の動画を確認します。2
ドラフトをフル品質でレンダリングする
ドラフトのジョブ ID を
draft_job_id として送信します。ドラフトの作成から 7 日以内に行ってください。それを過ぎるとドラフトはレンダリングできなくなり、新しいドラフトを生成する必要があります。cURL
draft_job_id だけを送信します。フルレンダリングではドラフトのプロンプト、リファレンス、シード、長さ、アスペクト比が再利用されるため、再送信する必要はありません。含めた場合も Krea はそれらを無視します。出力はデフォルトで 1080p です。4K でレンダリングするには "resolution": "4k" を追加します。JavaScript
ドラフトモードの課金
ドラフトは 480p の料金で課金されます。フルレンダリングは、ドラフトの長さに対して出力解像度での別個の Seedance 2.5 生成として課金されます。ドラフトでリファレンス動画を使用した場合、フルレンダリングは ByteDance が報告するトークンに基づいて課金され、そのトークンにはドラフトのリファレンス動画の長さが含まれます。 同じドラフトを同じ解像度で再度レンダリングすると、新しいジョブを作成して課金するのではなく、既存のフル品質ジョブが返されます。ドラフトモードの制限とエラー
- ドラフトモードに対応しているのは Seedance 2.5 のみです。Seedance 2.0、2.0 Fast、2.0 Mini は対応していません。
- レンダリングできるのは、同じワークスペースにある自分のドラフトのみです。
draft: trueとdraft_job_idを同じリクエストで送信しないでください。ドラフトを別のドラフトからレンダリングすることはできません。
よくある質問
Krea は ByteDance Seedance API を提供していますか?
はい。Krea は ByteDance Seedance 2.5、Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini をhttps://api.krea.ai の REST API で提供しています。Krea API トークンで認証し、上記の Seedance エンドポイントにリクエストを送信してください。
Seedance はテキストから動画と画像から動画の両方に使えますか?
はい。テキストから動画を生成するにはprompt を送信し、画像をアニメーション化するには start_image を追加します。どちらのワークフローも同じ Seedance モデルのエンドポイントを使用し、非同期ジョブを返します。
フル品質の料金を支払う前に Seedance の動画をプレビューできますか?
はい、Seedance 2.5 で可能です。"draft": true を送信すると、480p の料金で 480p のプレビューを取得できます。気に入った場合は、7 日以内にドラフトのジョブ ID を draft_job_id として送信すると、同じショットを 1080p でレンダリングできます。ドラフトモードを参照してください。