メインコンテンツへスキップ
Krea は ByteDance の Seedance 動画生成モデルへの API アクセスを提供しています。Krea の Seedance API を使うと、テキストから動画を生成したり、画像をアニメーション化したり、画像・動画・音声のリファレンスで生成をガイドしたりできます。リクエストには Krea API トークンと 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 の横長動画をリクエストします。
JavaScript SDK は 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
本番環境の連携では、Webhook を使用して完了イベントを受け取ってください。ジョブの状態と失敗時の対処については、ジョブライフサイクル と エラーとデバッグ を参照してください。

画像をアニメーション化する

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 SDK を使った同じ流れ:
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 でレンダリングできます。ドラフトモードを参照してください。

ByteDance の API キーを別途用意する必要はありますか?

いいえ。Krea を通じた Seedance の呼び出しには、Krea API トークンとワークスペースの API 残高が使用されます。これらのリクエストで ByteDance の認証情報を別途送信する必要はありません。

Krea での Seedance API の料金はいくらですか?

最新の Seedance の料金と利用可能な設定については、Krea API 料金 ↗ を参照してください。API の使用料は Krea アプリのコンピュートとは別に請求されます。失敗したジョブとキャンセルされたジョブは請求されません。

AI エージェントから Seedance を呼び出せますか?

はい。エージェントを Krea MCP サーバー に接続すると、利用可能な動画モデルとそのスキーマを検出できます。アプリケーションから REST API や JavaScript SDK を直接呼び出すこともできます。