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 InvalidCredential 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 uyumluluk endpoint’i content[] içinde text, image_url, video_url, audio_url ve draft_task öğelerini kabul eder. first_frame, last_frame ve reference_image gibi görsel rolleri korunur. callback_url henüz desteklenmez; görev endpoint’ini sorgulayın.

Referans sayfaları

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 Action örneği

curl 'https://api.tokenlab.sh/?Action=CreateContentsGenerationsTasks&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0",
    "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 Action ö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 Action ö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 Action örneği

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

Geçiş kontrol listesi