Müzik

Create Music

Müzik, şarkı sözü veya ses üretme görevi oluşturur

POST
/v1/music/generations

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

modelstringvarsayılan: suno-music

suno-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.

promptstring

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.

titlestring

Oluşturulan şarkı için başlık.

tagsstring

Tarz etiketleri (örn. "pop, upbeat, electronic").

negative_tagsstring

Kaçınılması gereken tarzlar. audio_operation değeri add-instrumental olduğunda zorunludur.

actionstring

İ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.

mvstring

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.

make_instrumentalboolean

Vokal içermeyen enstrümantal çıktı üretmek için true olarak ayarlayın.

audio_urlstring

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.

audio_operationstring

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.

task_idstring

Oluşturulan sesin değiştirilmesi veya stem ayrıştırma için kuruluşunuza ait kaynak görev kimliği (task ID).

audio_idstring

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.

infill_start_snumber

Saniye cinsinden değiştirme başlangıç zamanı, en az 0. replace-section için zorunludur.

infill_end_snumber

Saniye cinsinden değiştirme bitiş zamanı. replace-section için zorunludur; infill_start_s değerinden 6–60 saniye sonra olmalıdır.

full_lyricsstring

Elde edilecek şarkı için tam şarkı sözleri. replace-section için zorunludur.

stem_namestring

Stem adı. advanced-split için zorunludur.

continue_clip_idstring

Devam edilecek önceki klibin kimliği (ID).

continue_atnumber

Devam edilecek saniye cinsinden zaman. upload-extend için zorunludur ve 0'dan büyük olmalıdır.

durationinteger

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.

output_formatstring

Model tarafından listelenen ses dosyası formatı; örneğin mp3, wav veya flac. Sadece bunu listeleyen modeller için geçerlidir.

seedinteger

Tekrarlanabilir çıktı için seed değeri, 0 ile 4294967294 arası. Yalnızca bunu listeleyen modeller içindir.

stepsinteger

Ü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.

cfg_scalenumber

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

idstring

Durumu sorgulamak için görev kimliği (task ID).

task_idstring

Döndürüldüğünde, aynı asenkron görev kimliğinin (task ID) diğer adı.

poll_urlstring

Bu görev için durum URL'si. id ile GET /v1/tasks/{id} uç noktasını sorgulayın.

statusstring

Görev durumu: pending, processing, completed veya failed.

createdinteger

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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "suno-music"
}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

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

X-TokenLab-Delivery-Policy?string

İ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"
Idempotency-Key?string

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.

Uzunluk1 <= length <= 255

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json