> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Krea の ByteDance Seedance API

> Krea API で ByteDance Seedance 2.5 と 2.0 を利用。REST と JavaScript の例、API キー、料金リンクとともに、テキストや画像から動画を生成する方法を解説します。

Krea は ByteDance の Seedance 動画生成モデルへの API アクセスを提供しています。Krea の Seedance API を使うと、テキストから動画を生成したり、画像をアニメーション化したり、画像・動画・音声のリファレンスで生成をガイドしたりできます。リクエストには Krea API トークンと `https://api.krea.ai` のベース URL を使用します。

## 利用可能な Seedance API モデル

| モデル | POST エンドポイント | 動画の長さ | 出力解像度 |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4〜30 秒 | 480p、720p、1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4〜15 秒 | 480p、720p、1080p、4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4〜15 秒 | 480p、720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4〜15 秒 | 480p、720p |

これらのモデルは、テキストから動画、開始フレームと終了フレーム、リファレンスメディア、ネイティブ音声に対応しています。各モデルの最新のリクエストスキーマは [API リファレンス](https://www.krea.ai/docs/api-reference/introduction.md) を参照してください。ジョブを送信する前に [API 料金 ↗](https://www.krea.ai/app/api/pricing) を確認してください。料金はモデルと生成設定によって異なります。

> [!NOTE]
>
> Krea の Seedance 2.0 および 2.0 Fast エンドポイントには、ベースモデルに加えて、オプションの Krea プロンプト強化とアップスケーリングが含まれます。Seedance 2.5 にはオプションの Krea プロンプト強化が含まれます。`reference_videos` を使用した Seedance 2.5 の動画編集リクエストでは、出力の長さとアスペクト比はソース動画に基づいて決まり、`duration` と `aspect_ratio` は無視されます。

## Seedance API キーを取得する

[API キーと請求](https://www.krea.ai/docs/ja/developers/api-keys-and-billing.md) の手順に従って Krea API トークンを作成し、API 残高を追加してください。トークンはサーバー上の `KREA_API_KEY` 環境変数に保存します。`Authorization: Bearer $KREA_API_KEY` として送信し、ブラウザのコードには決して公開しないでください。

Krea アプリのコンピュートと API 残高は別々に管理されます。Krea API を通じた Seedance リクエストには、ワークスペースの API 残高が使用されます。

## 動画を生成する

テキストから動画を生成するには、Seedance 2.5 エンドポイントにプロンプトを送信します。以下の例では、5 秒間、720p の横長動画をリクエストします。

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

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` メソッドはポーリングを自動で処理します。

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

本番環境の連携では、[Webhook](https://www.krea.ai/docs/ja/developers/webhooks.md) を使用して完了イベントを受け取ってください。ジョブの状態と失敗時の対処については、[ジョブライフサイクル](https://www.krea.ai/docs/ja/developers/job-lifecycle.md) と [エラーとデバッグ](https://www.krea.ai/docs/ja/developers/errors-and-debugging.md) を参照してください。

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

Seedance で画像から動画を生成するには、同じエンドポイントを使用し、リクエストに `start_image` を追加します。公開アクセス可能な画像 URL、アップロード済みアセットの URL、または base64 データ URI を渡してください。

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

`start_image` はご自身の画像 URL に置き換えてください。最終フレームを制御するには `end_image` を追加します。リファレンスに基づく生成では、選択したモデルの [API スキーマ](https://www.krea.ai/docs/api-reference/introduction.md) に従って `reference_images`、`reference_videos`、`reference_audios` を使用します。

## よくある質問

### 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 モデルのエンドポイントを使用し、非同期ジョブを返します。

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

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

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

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

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

はい。エージェントを [Krea MCP サーバー](https://www.krea.ai/docs/ja/developers/mcp.md) に接続すると、利用可能な動画モデルとそのスキーマを検出できます。アプリケーションから REST API や JavaScript SDK を直接呼び出すこともできます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.