Ana içeriğe atla
Müzik üretimi asenkron bir süreçtir. POST /v1/music/generations bir kamu TokenLab görevi oluşturur ve id / task_id, status ve genellikle poll_url döner. Uygulamanız bu görev kimliğini saklamalı, ilerlemeyi göstermeli ve terminal durumu gelene kadar sorgulama yapmalıdır.

​
İş Akışını Seçin

İş AkışıAna alanlarNotlar
Tam şarkı veya enstrümantalmodel, prompt, isteğe bağlı title, tags, action: "MUSIC"Kullanıcı nihai sesi bekliyorsa kullanın
Sadece sözlermodel, prompt, action: "LYRICS"Sadece söz üretimi sunan modellerle kullanın
Mevcut bir klibi devam ettirincontinue_clip_id, isteğe bağlı continue_atDevam ettirmeden önce önceki kamu klip/görev kimliğini saklayın
Sabit kodlanmış bir model listesi göndermeden önce mevcut model kataloğunu sorgulayın: 
curl "https://api.tokenlab.sh/v1/models?recommended_for=music" \
  -H "Authorization: Bearer sk-your-api-key"
Mevcut kamu örnekleri müzik üretimi için suno_music kullanmaktadır. Sadece söz akışları için, söz üretimini belgeleyen bir model ile action: "LYRICS" gönderin. Model kimliklerini kamu TokenLab kimlikleri olarak değerlendirin, sağlayıcıya özgü alanların kamu sözleşme alanları olduğu garantisi olarak değil.

​
Bir Müzik Görevi Oluşturun

curl https://api.tokenlab.sh/v1/music/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno_music",
    "prompt": "Sıcak vokallere ve temiz bir nakarata sahip neşeli bir synth-pop parçası",
    "title": "Sabah Statik",
    "tags": "synth-pop, neşeli",
    "action": "MUSIC"
  }'
Promptları, başlıkları ve etiketleri kullanıcıya görünür ve saklamak için güvenli tutun. Hiçbir prompt alanına API anahtarları, özel URL’ler veya dahili yönlendirme bilgileri koymayın.

​
Tamamlanmayı Sorgulayın

Öncelikle poll_url kullanın. Eğer istemciniz sabit bir rota gerektiriyorsa, dönen id veya task_id ile GET /v1/tasks/{id} çağrısı yapın. 
curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"
Beklenen kamu durumları pending, processing, completed ve failed’dir. Tamamlanmış bir müzik görevi audio_url, video_url, title, lyrics ve normalize edilmiş meta veriler içerebilir. Nihai URL’leri kendi veritabanınızda saklayın, böylece kullanıcı sonucu yeniden açabilir ve üretimi yeniden başlatmak zorunda kalmaz.

​
UI Ve Durum Yönetimi

  • Görev oluşturulduktan hemen sonra bekleyen bir durumu gösterin.
  • Uzun görevler için her 5-10s’de bir sorgulama yapın, ardından completed veya failed durumunda durun.
  • Görev completed olduğunda ve bir audio_url mevcut olduğunda nihai bir oynatıcıyı görüntülemeyin.
  • Sadece söz görevleri için, kullanıcıların ne satın aldıklarını anlaması için metin çıktısını ses görevlerinden ayrı olarak render edin.
  • Yenileme sırasında, yeni bir görev oluşturmaktansa saklanan task_id ile devam edin.

​
Faturalama Ve Uzlaşma

Müzik görevleri, oluşturma zamanında tahmini bir miktarı rezerve edebilir ve terminal durumu bilindiğinde hesaplaşabilir. request_id, task_id, model, endpoint ve billing_transaction_id göründüğünde saklayın. Uzlaşma için sağlayıcı görev kimlikleri yerine Yönetim API kullanım kayıtlarını kullanın.

​
Yaygın Hatalar

BelirtiOlası nedenÇözüm
Görev oluşturuldu ama oynatıcı yokGörev hala beklemede veya audio_url olmadan tamamlandıTerminal duruma kadar sorgulamaya devam edin, ardından eksik çıktıyı başarısız bir kullanıcı işi olarak yönetin
Yenileme sonrası tekrar eden şarkılarUI görevi yeniden oluşturdu, devam etmeditask_id’yi saklayın ve yeniden kullanın
Söz görevi ses döndürmüyoraction: "LYRICS" sadece metinSözler ve müzik UI yollarını ayırın
Desteklenmeyen parametreAlan model kamu sözleşmesinde yokSağlayıcıya özgü alanları kaldırın veya bunları belgeleyen bir model seçin

​
API Referansı

KonuReferans
Müzik OluşturMüzik Oluştur
Müzik Durumunu AlMüzik Durumunu Al
Görev Durumunu AlGörev Durumunu Al
Modelleri ListeleModelleri Listele
Faturalama & FiyatlandırmaFaturalama & Fiyatlandırma