Seedance’i Volcengine’den taşıma

Uygulamanız zaten Volcengine biçiminde Seedance istekleri gönderiyorsa bu kılavuzu kullanın. Action adları, Version=2024-01-01, content[], PascalCase materyal gövdeleri ve Volcengine yanıt zarfı korunabilir. Yalnızca endpoint ve kimlik doğrulama değişir.

Değişenler

Konu	Mevcut Volcengine istemcisi	TokenLab
Temel URL	`Volcengine API`	`https://api.tokenlab.sh/`
Kimlik doğrulama	`AK/SK`	`Authorization: Bearer <TOKENLAB_API_KEY>`
Action isteği	`Action`, `Version`	`Action`, `Version`
Görev gövdesi	`content[]`	`content[]`
Materyal gövdesi	`PascalCase`	`PascalCase`
Asenkron sonuç	`Görev ID’si`	`cgt-...` + Polling

Yalnızca AK/SK imzası bulunan istekler 401 AuthenticationError döndürür. Action istemcileri POST /?Action=...&Version=2024-01-01 kullanabilir; POST /api/v3?Action=...&Version=2024-01-01 de kullanılmaya devam eder. REST görev istemcileri /api/v3/contents/generations/tasks yolunu kullanır.

İstek şekli ve görev yaşam döngüsü

Entegrasyonunuz zaten Volc tarzı Seedance istekleri gönderiyorsa, body’yi /v1/videos/generations formatına dönüştürmek yerine uyumluluk endpoint’ini kullanabilirsiniz. TokenLab API key’i Authorization: Bearer ... olarak gönderin; REST oluşturma için POST /api/v3/contents/generations/tasks, Action tarzı istekler için /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 kullanın. Oluşturma yanıtı cgt-... görev ID’si döndürür; durum yanıtları queued, running, succeeded, failed, cancelled veya expired kullanır. Bu endpoint content[] içinde text, image_url, video_url, audio_url ve draft_task öğelerini kabul eder. callback_url, queued, running, succeeded, failed veya expired durumlarına her geçişte sorgu nesnesinin aynısını alır; succeeded ve failed beş saniye sonra en fazla üç kez yeniden denenir. Sorgulamayı yedek yol olarak koruyun.

Referans sayfaları

v3 için /v1/tasks/{id} yanıt struct’ını yeniden kullanmayın. v1 pending, processing, completed ve failed; v3 queued, running, succeeded, failed, cancelled ve expired kullanır. v3’te duration bir string’dir ve error yalnızca başarısızlıkta görünür. Bağlantı koptuktan sonra kurtarma için REST oluşturmada benzersiz bir Idempotency-Key gönderin. Aynı body ve key aynı cgt-... ID’sini döndürür; aynı key ile farklı bir body 409 döndürür.

Görev Action’ları

Action	Konu	JSON
`CreateContentsGenerationsTasks`	Video görevi oluşturma	`model`, `content[]`
`GetContentsGenerationsTask`	Tek görevi alma	`TaskId`
`ListContentsGenerationsTasks`	Görevleri listeleme	Filtreler, sayfalama
`DeleteContentsGenerationsTasks`	Görevi iptal etme veya silme	`TaskId`

En küçük REST örneği

curl 'https://api.tokenlab.sh/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Idempotency-Key: $CLIENT_JOB_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.5",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

Materyaller ve gerçek kişi doğrulaması

Aynı Action endpoint’i on materyal ve grup işlemini de destekler. PascalCase gövdeler, filtreler, sayfalama, yanıt zarfı ve 12 saatlik materyal URL’leri için Volcengine uyumlu materyal Action’ları sayfasına bakın. Gerçek kişi materyali yüklemeden önce ayrıca Görsel doğrulama oturumu oluştur ve Görsel doğrulama sonucunu al çağrıları gerekir.

Geçiş kontrol listesi

API host’unu https://api.tokenlab.sh ile değiştirin.
AK/SK imzasını TokenLab Bearer API Key ile değiştirin.
Mevcut Action, sürüm ve gövde harf düzenini koruyun.
İlişkili materyal ve doğrulama isteklerinde aynı ProjectName değerini kullanın.
TokenLab’in döndürdüğü görev, grup ve materyal ID’lerini saklayın.
Üretim trafiğini taşımadan önce oluşturma, polling, liste ve hata yanıtlarını doğrulayın.

Başlarken

Temel kılavuzlar

Medya kılavuzları

Seedance’i Volcengine’den taşıma

Değişenler

İstek şekli ve görev yaşam döngüsü

Referans sayfaları

Görev Action’ları

En küçük REST örneği

Materyaller ve gerçek kişi doğrulaması

Geçiş kontrol listesi

​Değişenler

​İstek şekli ve görev yaşam döngüsü

​Referans sayfaları

​Görev Action’ları

​En küçük REST örneği

​Materyaller ve gerçek kişi doğrulaması

​Geçiş kontrol listesi

Değişenler

İstek şekli ve görev yaşam döngüsü

Referans sayfaları

Görev Action’ları

En küçük REST örneği

Materyaller ve gerçek kişi doğrulaması

Geçiş kontrol listesi