> ## 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.

# ByteDance Seedance API di Krea

> Gunakan ByteDance Seedance 2.5 dan 2.0 melalui Krea API. Hasilkan video dari teks atau gambar dengan contoh REST dan JavaScript, API key, serta tautan harga.

Krea menyediakan akses API ke model generasi video Seedance dari ByteDance. Gunakan Seedance API di Krea untuk menghasilkan video dari teks, menganimasikan gambar, atau memandu generasi dengan referensi gambar, video, dan audio. Permintaan menggunakan token API Krea dan base URL `https://api.krea.ai`.

## Model Seedance API yang tersedia

| Model | Endpoint POST | Durasi video | Resolusi output |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30 detik | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15 detik | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15 detik | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15 detik | 480p, 720p |

Model-model ini mendukung text-to-video, frame awal dan akhir, media referensi, serta audio native. Lihat [referensi API](https://www.krea.ai/docs/api-reference/introduction.md) untuk skema permintaan terbaru setiap model. Periksa [harga API ↗](https://www.krea.ai/app/api/pricing) sebelum mengirimkan job; harga bergantung pada model dan pengaturan generasi.

> [!NOTE]
>
> Endpoint Seedance 2.0 dan 2.0 Fast di Krea menyertakan peningkatan prompt Krea dan upscaling opsional di luar model dasarnya. Seedance 2.5 menyertakan peningkatan prompt Krea opsional. Untuk permintaan pengeditan video Seedance 2.5 dengan `reference_videos`, panjang dan rasio aspek output mengikuti video sumber; `duration` dan `aspect_ratio` diabaikan untuk permintaan tersebut.

## Mendapatkan API key Seedance

Buat token API Krea dan isi saldo API melalui [API Keys & Billing](https://www.krea.ai/docs/id/developers/api-keys-and-billing.md). Simpan token di variabel lingkungan `KREA_API_KEY` pada server Anda. Kirimkan sebagai `Authorization: Bearer $KREA_API_KEY`; jangan pernah mengeksposnya di kode browser.

Compute aplikasi Krea dan saldo API terpisah. Permintaan Seedance melalui Krea API menggunakan saldo API workspace Anda.

## Menghasilkan video

Kirimkan prompt ke endpoint Seedance 2.5 untuk generasi text-to-video. Contoh berikut meminta video lanskap 720p berdurasi lima detik.

```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]);
```

Instal SDK JavaScript dengan `npm install @krea-ai/sdk`. Permintaan REST mengembalikan `job_id`, bukan video yang sudah jadi. Lakukan polling `GET /jobs/{job_id}` setiap 2–5 detik hingga `status` bernilai `completed`, lalu baca URL video dari `result.urls[0]`. Hentikan polling jika status `failed` atau `cancelled`. Metode `jobs.wait` pada SDK menangani polling untuk Anda.

```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"
```

Untuk integrasi produksi, gunakan [webhook](https://www.krea.ai/docs/id/developers/webhooks.md) untuk menerima event penyelesaian. Lihat [job lifecycle](https://www.krea.ai/docs/id/developers/job-lifecycle.md) serta [error dan debugging](https://www.krea.ai/docs/id/developers/errors-and-debugging.md) untuk status job dan penanganan kegagalan.

## Menganimasikan gambar

Untuk generasi image-to-video dengan Seedance, gunakan endpoint yang sama dan tambahkan `start_image` ke permintaan Anda. Berikan URL gambar yang dapat diakses publik, URL aset yang diunggah, atau base64 data 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"
}
```

Ganti `start_image` dengan URL gambar Anda sendiri. Untuk mengontrol frame terakhir, tambahkan `end_image`. Untuk generasi berbasis referensi, gunakan `reference_images`, `reference_videos`, dan `reference_audios` sesuai dengan [skema API](https://www.krea.ai/docs/api-reference/introduction.md) model yang dipilih.

## Pertanyaan yang sering diajukan

### Apakah Krea menawarkan ByteDance Seedance API?

Ya. Krea menawarkan ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast, dan Seedance 2.0 Mini melalui REST API-nya di `https://api.krea.ai`. Lakukan autentikasi dengan token API Krea dan kirimkan permintaan ke salah satu endpoint Seedance yang tercantum di atas.

### Bisakah saya menggunakan Seedance untuk text-to-video dan image-to-video?

Ya. Kirimkan `prompt` untuk text-to-video, atau tambahkan `start_image` untuk menganimasikan gambar. Kedua alur kerja menggunakan endpoint model Seedance yang sama dan mengembalikan job asinkron.

### Apakah saya memerlukan API key ByteDance terpisah?

Tidak. Panggilan ke Seedance melalui Krea menggunakan token API Krea dan saldo API workspace Anda. Anda tidak perlu mengirimkan kredensial ByteDance terpisah dengan permintaan ini.

### Berapa biaya Seedance API di Krea?

Lihat [harga Krea API ↗](https://www.krea.ai/app/api/pricing) untuk harga Seedance terbaru dan pengaturan yang tersedia. Penggunaan API ditagih terpisah dari compute aplikasi Krea. Job yang gagal dan dibatalkan tidak ditagih.

### Bisakah saya memanggil Seedance dari agen AI?

Ya. Hubungkan agen ke [server MCP Krea](https://www.krea.ai/docs/id/developers/mcp.md) untuk menemukan model video yang tersedia beserta skemanya. Anda juga dapat memanggil REST API atau SDK JavaScript langsung dari aplikasi Anda.


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