switch_heading

Seedance 1.5 API Dokümantasyonu

Seedance 1.5 video üretim API'sini uygulamalarınıza entegre etmek için tam kılavuz.

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

Hızlı Başlangıç

bash

1	curl -X POST 'https://seedanceapi.org/v1/generate' \
2	-H 'Authorization: Bearer YOUR_API_KEY' \
3	-H 'Content-Type: application/json' \
4	-d '{
5	"prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "8"
9	}'

Kimlik Doğrulama

Tüm API istekleri Authorization başlığında Bearer token kullanılarak kimlik doğrulaması gerektirir.

Önemli: API anahtarınızı panelinizdeki API Keys sayfasından alabilirsiniz. → API anahtarı al

http

1	Authorization: Bearer YOUR_API_KEY

Fiyatlandırma

480p

480p Çözünürlük

Hızlı üretim, önizleme ve taslaklar için uygun

Süre	Ses olmadan	Ses ile
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p Çözünürlük

Yüksek kalite çıktı, üretim için önerilir

Süre	Ses olmadan	Ses ile
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

API Uç Noktaları

POST/v1/generateYeni video oluştur

Seedance 1.5 modeli ile yeni video üretim görevi oluşturun. Metinden-video ve resimden-video modlarını destekler.

İstek Gövdesi

Body ParametersJSON

prompt:string

Üretilecek videonun metin açıklaması (maks. 2000 karakter)

aspect_ratio:optional string

Çıkış en-boy oranı. Desteklenen: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

Video çözünürlüğü: 480p veya 720p Defaults to 720p.

duration:optional string

Video süresi saniye olarak: 4, 8 veya 12 Defaults to 8.

generate_audio:optional boolean

Video için AI ses üretimini etkinleştir Defaults to false.

fixed_lens:optional boolean

Hareket bulanıklığını azaltmak için kamerayı sabitle Defaults to false.

image_urls:optional string[]

Resimden-video üretimi için referans resim URL'leri dizisi (maks. 1)

callback_url:optional string

Asenkron durum bildirimleri için webhook URL'si. Herkese açık erişilebilir olmalıdır.

Metinden video

json

1	{
2	"prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8"
6	}

Resimden video

json

1	{
2	"prompt": "The character slowly turns and smiles at the camera",
3	"image_urls": [
4	"https://example.com/my-image.jpg"
5	],
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "4"
9	}

Ses üretimi ile

json

1	{
2	"prompt": "A peaceful river flowing through a forest with birds singing",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8",
6	"generate_audio": true,
7	"fixed_lens": true
8	}

Yanıtlar

Task created successfully

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "IN_PROGRESS"
7	}
8	}

GET/v1/statusGörev durumunu al

Video üretim görevinin durumunu kontrol edin ve tamamlandığında sonucu alın.

Sorgu Parametreleri

Body ParametersJSON

task_id:string

Generate uç noktasından dönen benzersiz görev ID'si

Örnek İstek

bash

1	curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2	-H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Durum API'sindeki response alanı video URL'leri dizisidir. Video URL'sini almak için doğrudan data.response[0]'e erişebilirsiniz.

javascript

1	// Extract video URL from response
2	const videoUrl = data.response[0];

Yanıtlar

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "SUCCESS",
7	"consumed_credits": 28,
8	"created_at": "2026-02-07T10:30:00Z",
9	"request": {
10	"prompt": "A majestic eagle soaring through golden sunset clouds",
11	"aspect_ratio": "16:9",
12	"resolution": "720p",
13	"duration": "8"
14	},
15	"response": [
16	"https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17	],
18	"error_message": null
19	}
20	}

API Oyun Alanı

API'yi doğrudan tarayıcınızdan test edin. YOUR_API_KEY'i gerçek API anahtarınızla değiştirin.

API AlanıPOST

Temel URL

Uç Nokta

Başlıklar

İstek Gövdesi

Hata Kodları

Status	Code	Description
400 Geçersiz İstek	`INVALID_PROMPT`	Prompt geçersiz veya boş
400 Geçersiz İstek	`INVALID_ASPECT_RATIO`	Desteklenmeyen en-boy oranı
400 Geçersiz İstek	`INVALID_RESOLUTION`	Çözünürlük 480p veya 720p olmalıdır
400 Geçersiz İstek	`INVALID_DURATION`	Süre 4, 8 veya 12 saniye olmalıdır
400 Geçersiz İstek	`TOO_MANY_IMAGES`	image_urls dizisinde en fazla 1 resim URL'sine izin verilir
401 Yetkisiz	`INVALID_API_KEY`	API anahtarı eksik veya geçersiz
402	`INSUFFICIENT_CREDITS`	Bu işlem için yeterli kredi yok
404 Bulunamadı	`TASK_NOT_FOUND`	Görev ID'si bulunamadı veya hesabınıza ait değil
500 Sunucu Hatası	`INTERNAL_ERROR`	Sunucu hatası, lütfen daha sonra tekrar deneyin

switch_heading