> ## 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 üzerinde ByteDance Seedance API

> ByteDance Seedance 2.5 ve 2.0'ı Krea API üzerinden kullanın. REST ve JavaScript örnekleri, API anahtarları ve fiyatlandırma bağlantılarıyla metinden veya görsellerden video üretin.

Krea, ByteDance'in Seedance video üretim modellerine API erişimi sağlar. Krea üzerindeki Seedance API'yi metinden video üretmek, görselleri canlandırmak veya üretimi görsel, video ve ses referanslarıyla yönlendirmek için kullanın. İstekler bir Krea API tokenı ve `https://api.krea.ai` temel URL'sini kullanır.

## Kullanılabilir Seedance API modelleri

| Model | POST uç noktası | Video süresi | Çıktı çözünürlüğü |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30 saniye | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15 saniye | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15 saniye | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15 saniye | 480p, 720p |

Bu modeller metinden videoyu, başlangıç ve bitiş karelerini, referans medyayı ve yerel sesi destekler. Her modelin güncel istek şeması için [API referansına](https://www.krea.ai/docs/api-reference/introduction.md) bakın. Bir iş göndermeden önce [API fiyatlandırmasını ↗](https://www.krea.ai/app/api/pricing) kontrol edin; fiyat, modele ve üretim ayarlarına bağlıdır.

> [!NOTE]
>
> Krea'nın Seedance 2.0 ve 2.0 Fast uç noktaları, temel modelin ötesinde isteğe bağlı Krea prompt iyileştirme ve yükseltme (upscaling) içerir. Seedance 2.5 isteğe bağlı Krea prompt iyileştirme içerir. `reference_videos` içeren Seedance 2.5 video düzenleme isteklerinde çıktı uzunluğu ve en boy oranı kaynak videodan alınır; bu isteklerde `duration` ve `aspect_ratio` yok sayılır.

## Seedance API anahtarı edinme

[API Anahtarları ve Faturalandırma](https://www.krea.ai/docs/tr/developers/api-keys-and-billing.md) sayfasını kullanarak bir Krea API tokenı oluşturun ve API bakiyesi ekleyin. Tokenı sunucunuzda `KREA_API_KEY` ortam değişkeninde saklayın. Tokenı `Authorization: Bearer $KREA_API_KEY` olarak gönderin; tarayıcı kodunda asla açığa çıkarmayın.

Krea uygulama işlem gücü (compute) ve API bakiyesi birbirinden ayrıdır. Krea API üzerinden yapılan Seedance istekleri çalışma alanınızın API bakiyesini kullanır.

## Video üretme

Metinden video üretimi için Seedance 2.5 uç noktasına bir prompt gönderin. Bu örnekler beş saniyelik, 720p yatay bir video ister.

```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'yı `npm install @krea-ai/sdk` ile yükleyin. REST isteği bitmiş videoyu değil, bir `job_id` döndürür. `status` değeri `completed` olana kadar her 2–5 saniyede bir `GET /jobs/{job_id}` isteğiyle polling yapın, ardından video URL'sini `result.urls[0]` alanından okuyun. `failed` veya `cancelled` durumunda polling'i durdurun. SDK'nın `jobs.wait` metodu polling işlemini sizin yerinize yapar.

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

Üretim entegrasyonlarında tamamlanma olaylarını almak için [webhook'ları](https://www.krea.ai/docs/tr/developers/webhooks.md) kullanın. İş durumları ve hata yönetimi için [İş Yaşam Döngüsü](https://www.krea.ai/docs/tr/developers/job-lifecycle.md) ile [Hatalar ve Hata Ayıklama](https://www.krea.ai/docs/tr/developers/errors-and-debugging.md) sayfalarına bakın.

## Görsel canlandırma

Seedance ile görselden video üretimi için aynı uç noktayı kullanın ve isteğinize `start_image` ekleyin. Herkese açık erişilebilen bir görsel URL'si, yüklenmiş bir varlık URL'si veya base64 data URI gönderin.

```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` değerini kendi görsel URL'nizle değiştirin. Son kareyi kontrol etmek için `end_image` ekleyin. Referansla yönlendirilen üretim için seçilen modelin [API şemasına](https://www.krea.ai/docs/api-reference/introduction.md) uygun şekilde `reference_images`, `reference_videos` ve `reference_audios` alanlarını kullanın.

## Sıkça sorulan sorular

### Krea bir ByteDance Seedance API sunuyor mu?

Evet. Krea; ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast ve Seedance 2.0 Mini modellerini `https://api.krea.ai` adresindeki REST API'si üzerinden sunar. Bir Krea API tokenı ile kimlik doğrulaması yapın ve yukarıda listelenen Seedance uç noktalarından birine istek gönderin.

### Seedance'i hem metinden videoya hem de görselden videoya kullanabilir miyim?

Evet. Metinden video için bir `prompt` gönderin veya bir görseli canlandırmak için `start_image` ekleyin. Her iki iş akışı da aynı Seedance model uç noktasını kullanır ve asenkron bir iş döndürür.

### Ayrı bir ByteDance API anahtarına ihtiyacım var mı?

Hayır. Krea üzerinden yapılan Seedance çağrıları Krea API tokenınızı ve çalışma alanı API bakiyenizi kullanır. Bu isteklerle ayrı bir ByteDance kimlik bilgisi göndermeniz gerekmez.

### Seedance API'nin Krea üzerindeki maliyeti nedir?

Güncel Seedance fiyatları ve kullanılabilir ayarlar için [Krea API fiyatlandırmasına ↗](https://www.krea.ai/app/api/pricing) bakın. API kullanımı, Krea uygulama işlem gücünden ayrı olarak faturalandırılır. Başarısız ve iptal edilen işler faturalandırılmaz.

### Seedance'i bir yapay zeka ajanından çağırabilir miyim?

Evet. Kullanılabilir video modellerini ve şemalarını keşfetmek için bir ajanı [Krea MCP sunucusuna](https://www.krea.ai/docs/tr/developers/mcp.md) bağlayın. REST API'yi veya JavaScript SDK'yı doğrudan uygulamanızdan da çağırabilirsiniz.


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