Müzik
Create Music
Müzik, şarkı sözü veya ses üretme görevi oluşturur
Güncel müzik modellerini almak için GET /v1/models?recommended_for=music uç noktasını kullanın.
Yapay zeka ile müzik, şarkı sözü ve ses üretin. Bu asenkron bir API'dir. Oluşturma yanıtları bir görev kimliği döndürür. Durumu öğrenmek için bu kimlikle GET /v1/tasks/{id} uç noktasını sorgulayın.
Modeller kabul ettikleri alanlar açısından farklılık gösterir. İsteğe bağlı alanları göndermeden önce GET /v1/models/{model} uç noktasını kontrol edin; modelin listelemediği bir alan 400 unsupported_parameter hatası döndürebilir. Suno alanları (mv, title, tags, negative_tags, audio_operation ve bunlarla birlikte kullanılan alanlar) Suno modelleri için geçerlidir. user desteklenmez ve 400 hatası döndürür.
İstek Gövdesi
suno-musicsuno-music veya stable-audio-3 gibi müzik modeli ID'si. Açıkça belirtilmelidir. Yalnızca şarkı sözü için, mevcut genel işlemleri lyrics içeren bir model seçin.
Müzik açıklaması veya değiştirme metni. Müzik, şarkı sözü, upload-cover, upload-extend ve replace-section için zorunludur; add-instrumental ve stem ayrıştırma için isteğe bağlıdır.
Oluşturulan şarkı için başlık.
Tarz etiketleri (örn. "pop, upbeat, electronic").
Kaçınılması gereken tarzlar. audio_operation değeri add-instrumental olduğunda zorunludur.
İsteğe bağlı MUSIC veya LYRICS değeri. İlgili genel işlemi destekleyen bir model seçin; bu alan yalnızca müzik üreten bir modele şarkı sözü desteği eklemez.
Suno sürüm seçicisi. Oluşturma, upload-cover, upload-extend, add-instrumental ve audio_url üzerinden değiştirme için zorunludur. Şarkı sözü, task_id + audio_id üzerinden değiştirme ve stem ayrıştırma için dahil etmeyin. Kabul edilen değerler: chirp-v6, chirp-v6-mini, chirp-v6-wild.
Vokal içermeyen enstrümantal çıktı üretmek için true olarak ayarlayın.
Herkese açık olarak erişilebilir referans veya yüklenen ses URL'si. audio_operation olmadan sağlandığında TokenLab, upload-cover akışını kullanır.
Ses işlemi: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation ve advanced-split, task_id + audio_id gerektirir; advanced-split ayrıca stem_name gerektirir. upload-extend, 0'dan büyük bir continue_at değeri gerektirir. add-instrumental, audio_url, title, tags ve negative_tags gerektirir.
replace-section için prompt, tags, title, infill_start_s, infill_end_s ve full_lyrics gönderin. Tam olarak bir kaynak seçin: task_id + audio_id veya audio_url + mv. Değiştirme aralığı 6–60 saniye olmalıdır.
Oluşturulan sesin değiştirilmesi veya stem ayrıştırma için kuruluşunuza ait kaynak görev kimliği (task ID).
Kaynak görev sonucunda döndürülen kaynak ses kimliği (audio ID). Oluşturulan sesin değiştirilmesi ve stem ayrıştırma için task_id ile birlikte zorunludur.
Saniye cinsinden değiştirme başlangıç zamanı, en az 0. replace-section için zorunludur.
Saniye cinsinden değiştirme bitiş zamanı. replace-section için zorunludur; infill_start_s değerinden 6–60 saniye sonra olmalıdır.
Elde edilecek şarkı için tam şarkı sözleri. replace-section için zorunludur.
Stem adı. advanced-split için zorunludur.
Devam edilecek önceki klibin kimliği (ID).
Devam edilecek saniye cinsinden zaman. upload-extend için zorunludur ve 0'dan büyük olmalıdır.
Oluşturulan sesin saniye cinsinden uzunluğu, 1 ile 380 arası. Yalnızca stable-audio-3 gibi bunu listeleyen modeller içindir; modelin ayrıntıları kendi sınırını belirtir.
Model tarafından listelenen ses dosyası formatı; örneğin mp3, wav veya flac. Sadece bunu listeleyen modeller için geçerlidir.
Tekrarlanabilir çıktı için seed değeri, 0 ile 4294967294 arası. Yalnızca bunu listeleyen modeller içindir.
Üretim adımlarının sayısı. Aralık modele bağlıdır (örneğin stable-audio-3 için 4 ila 8 arası). Sadece bunu listeleyen modeller için geçerlidir.
Bazı modeller negative_prompt, n, seconds ve guidance_scale gibi daha fazla alan listeler. Bunları yalnızca modelin detaylarında listelendiğinde gönderin; seçilen modelin kabul etmediği bir alan 400 hatası döndürür.
Prompt yönlendirme gücü, 1 ile 25 arası. Yalnızca bunu listeleyen modeller içindir.
prompt en fazla 5000 karakter kabul eder; tags ve negative_tags alanlarının her biri en fazla 1000 karakter kabul eder. Desteklenen işlemler ve parametreler, seçilen modelin güncel ayrıntılarına bağlıdır.
Yanıt
Durumu sorgulamak için görev kimliği (task ID).
Döndürüldüğünde, aynı asenkron görev kimliğinin (task ID) diğer adı.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} uç noktasını sorgulayın.
Görev durumu: pending, processing, completed veya failed.
Döndürüldüğünde, Unix zaman damgası olarak görevin oluşturulma zamanı.
İstek
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"mv": "chirp-v6",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Suno alanları yerine duration ve output_format alanlarını kabul eden bir model için ses üretimi örneği:
{
"model": "stable-audio-3",
"prompt": "Warm lo-fi beat with soft vinyl crackle",
"duration": 30,
"output_format": "mp3"
}Yanıt
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.
1 <= length <= 255İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json