TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Müzik

Müzik Oluştur

Suno kullanarak bir müzik oluşturma görevi oluşturur

POST
/v1/music/generations

Yapay zeka kullanarak müzik ve şarkı sözü oluşturun. Bu asenkron bir API'dir. Oluşturma yanıtları görev kimliğini döndürür ve uygun olduğunda tercih edilen poll_url değerini de içerebilir.

İstek Gövdesi

modelstringvarsayılan: suno_music

Müzik model ID’si; örneğin suno-music. Yalnızca şarkı sözü için güncel genel işlemleri lyrics içeren bir model seçin.

promptstring

Müzik açıklaması veya değiştirme metni. Müzik, söz, upload-cover, upload-extend ve replace-section için zorunludur; add-instrumental ve kanal ayırma için isteğe bağlıdır.

titlestring

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

tagsstring

Tarz etiketleri (örneğin, "pop, upbeat, electronic").

negative_tagsstring

Kaçınılacak stiller. audio_operation add-instrumental olduğunda zorunludur.

actionstring

İsteğe bağlı MUSIC veya LYRICS değeri. İlgili genel işlemi destekleyen modeli seçin; bu alan yalnızca müzik destekleyen modele söz üretme yeteneği eklemez.

mvstring

Suno sürüm seçicisi. Üretim, upload-cover, upload-extend, add-instrumental ve audio_url kaynaklı değiştirme için zorunludur. Söz, task_id + audio_id kaynaklı değiştirme ve kanal ayırmada kullanmayın. Kabul edilen değerler: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.

make_instrumentalboolean

Vokalsiz enstrümantal çıktı üretmek için true gönderin.

audio_urlstring

Herkese açık erişilebilir referans veya yüklenmiş ses URL'si. audio_operation olmadan gönderilirse 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 için task_id + audio_id; advanced-split için ayrıca stem_name gerekir. upload-extend için 0’dan büyük continue_at gerekir. add-instrumental için audio_url, title, tags ve negative_tags gerekir.

replace-section için prompt, tags, title, infill_start_s, infill_end_s ve full_lyrics gerekir. 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

Üretilen sesi değiştirmek veya kanalları ayırmak için kuruluşunuza ait kaynak görev ID’si.

audio_idstring

Kaynak görev sonucunda dönen ses ID’si. Üretilen sesi değiştirme ve kanal ayırma için task_id ile birlikte zorunludur.

infill_start_snumber

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

infill_end_snumber

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

full_lyricsstring

Sonuç şarkısının tam sözleri. replace-section için zorunludur.

stem_namestring

Ses kanalı adı. advanced-split için zorunludur.

continue_clip_idstring

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

continue_atnumber

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

prompt en fazla 5000; tags ve negative_tags ayrı ayrı en fazla 1000 karakter kabul eder. Desteklenen işlemler ve parametreler güncel model ayrıntılarına bağlıdır.

Yanıt

idstring

Durum sorgulama için görev kimliği (task ID).

task_idstring

Aynı asenkron görev ID’sinin takma adı; döndürüldüğünde mevcuttur.

poll_urlstring

Uygun olduğunda dönen öncelikli polling URL'si.

statusstring

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

createdinteger

Döndürüldüğünde görevin oluşturulma Unix zaman damgası.

İ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-v4",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

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"

İstek gövdesi

application/json

Yanıt

application/json

application/json

Realtime WebSocket

Önceki

Müzik Durumunu Al

Sonraki