Ses

Suno V5

Suno API, istemlerden, stillerden ve şarkı sözlerinden stüdyo kalitesinde müzik oluşturur; asenkron ve üretime uygun teslimatla her çalıştırmada iki parça döndürür.

$0.12 / use

Çalıştırma başına 2 parçaAsenkron iş akışıİstem ve şarkı sözü kontrolüMP3 + kapak resmi

Parametreler

Model Version*

Custom Mode*

Etkin

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Devre Dışı

Vocal Gender Preference

Çıktı

Oluşturulan içerik burada görünecek

Uç Noktalar

POSThttps://api.apixo.ai/api/v1/generateTask/sunoGörev oluştur

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Sorgulama durumu

Kimlik Doğrulama

API erişimi kontrol ediliyor...

Ücretsiz kredilerinizi almak, Playground'u test etmek ve API entegrasyonuna geçmek için giriş yapın.

İstek gövdesi

request_type

async

Webhook'lar için callback_url ile geri çağırma kullanın.

provider

official

Seedance 2.0 kılavuzuyla eşleşir.

input

nesne

Mod, istem, referanslar, boyut, süre ve ses ayarları.

Parametreler

request_typegerekli

Türselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlkoşullu

Türtext

Publicly accessible URL for callback mode.Sadece request_type=callback

modegerekli

Türselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModegerekli

Türboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titlegerekli

Türtext

Appears in metadata and can steer theme. Required when Custom Mode is on.Sadece customMode=

stylegerekli

Türstring

Describe genre/mood/instrumentation. Required in Custom Mode.Sadece customMode=

promptkoşullu

Türstring

Provide full lyrics for sung output. Required when Instrumental is off.Sadece customMode=

songDescriptiongerekli

Türstring

Simple mode: one field to steer both style and topic when Custom Mode is off.Sadece customMode=

instrumentalgerekli

Türboolean

Turn on to generate backing track without vocals.

negativeTagskoşullu

Türstring

Negative TagsSadece customMode=

styleWeightkoşullu

Türslider

How strongly to follow the Style description.Sadece customMode=

weirdnessConstraintkoşullu

Türslider

Push creativity/experimentation. Higher = wilder.Sadece customMode=

audioWeightkoşullu

Türslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Sadece customMode=

vocalGenderkoşullu

Türselect

Best-effort vocal timbre preference (custom mode only).f · mSadece customMode=

Parametre	Tür	Gerekli	Açıklama
`request_type`	select	gerekli	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	koşullu	Publicly accessible URL for callback mode.Sadece request_type=callback
`mode`	select	gerekli	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	gerekli	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	gerekli	Appears in metadata and can steer theme. Required when Custom Mode is on.Sadece customMode=
`style`	string	gerekli	Describe genre/mood/instrumentation. Required in Custom Mode.Sadece customMode=
`prompt`	string	koşullu	Provide full lyrics for sung output. Required when Instrumental is off.Sadece customMode=
`songDescription`	string	gerekli	Simple mode: one field to steer both style and topic when Custom Mode is off.Sadece customMode=
`instrumental`	boolean	gerekli	Turn on to generate backing track without vocals.
`negativeTags`	string	koşullu	Negative TagsSadece customMode=
`styleWeight`	slider	koşullu	How strongly to follow the Style description.Sadece customMode=
`weirdnessConstraint`	slider	koşullu	Push creativity/experimentation. Higher = wilder.Sadece customMode=
`audioWeight`	slider	koşullu	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Sadece customMode=
`vocalGender`	select	koşullu	Best-effort vocal timbre preference (custom mode only).f · mSadece customMode=

Örnek (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Tam API dokümantasyonu

Örnek çıktılar

APIXO üzerindeki Suno V5 API ile oluşturuldu

2 İzlemeler

Neon Freeway Nights

Görüntüle

Tam Kılavuz

Suno API nedir?

Suno API, hızlı üretim iş akışları için tasarlanmış bir metinden müziğe oluşturma arayüzüdür. İstemleri, stil etiketlerini ve özel şarkı sözlerini, ilgili kapak görselleriyle birlikte iki tam şarkı çıktısına dönüştürebilir.

Bu özellik; hızlı yinelemenin manuel kompozisyondan daha önemli olduğu içerik üretici araçları, markalı içerik oluşturma ve otomatik müzik prodüksiyonu kullanım durumları için uygun hale getirir.

Oluşturma İş Akışı Nasıl Çalışır?

Sadece istem veya özel şarkı sözü modu parametreleriyle bir oluşturma isteği gönderin.
Görev durumunu yoklama (polling) veya geri çağırma (callback) uç noktası aracılığıyla asenkron olarak alın.
Başarılı olduğunda, oluşturulan iki parçayı ve ilgili kapak görseli meta verilerini tüketir.

Suno API Teknik Özellikler

Ürün ve arka uç entegrasyonuyla ilgili operasyonel özellikler.

Çıktılar

Oluşturma başına 2 parça

Kontrol Yüzeyi

Stil, tuhaflık, ses ağırlığı

Oluşturma Modları

Sadece istem ve özel şarkı sözü modu

Teslimat

Asenkron yoklama veya geri çağırma

Temel yetenekler

Çift Kanallı Çıktı

Her oluşturma iki şarkı varyantı döndürerek üretim ekipleri için A/B seçimini ve yaratıcı yinelemeyi hızlandırır.

Yaratıcı Kontrol Sürgüleri

Çıktıları güvenli ticari parçalardan deneysel dokulara taşımak için stil ağırlığı, tuhaflık ve ses ağırlığını ayarlayın.

Şarkı Sözü ve Vokal İş Akışları

Sadece istemle oluşturmayı ve isteğe bağlı enstrümantal ve vokal cinsiyet tercihleriyle özel şarkı sözü modunu destekler.

Asenkron Entegrasyona Hazır

Sorgulama (polling) veya geri çağırma (callback) stratejileriyle çalışarak kuyruk tabanlı arka uç iş akışlarına entegrasyonu kolaylaştırır.

Neler inşa edebilirsiniz?

Uygulama İçi Müzik Oluşturma

UGC, kısa video ve sosyal içerik oluşturma araçları için markalı müzik kesitleri ve içerik üretici dostu parçalar oluşturun.

Podcast ve Video Markalama

Kontrol edilebilir ruh hali ve tempo ile giriş ve çıkış parçaları, jingle'lar ve yinelenen tema motifleri oluşturun.

Kısa Form İçerik Müzikleri

Stil ve şarkı sözü kancaları etrafında hızlı yineleme ile TikTok, Shorts ve Reels için özel arka plan müzikleri oluşturun.

Oyun ve Etkileşimli Ses

Oyunlar ve etkileşimli deneyimler için ortam döngüleri, menü temaları ve hafif müzik fikirleri prototipleyin.

Notlar ve sınırlamalar

Her oluşturma tam olarak iki kanal döndürür; çıktı sayısı özelleştirilemez.
Playground iş akışı asenkron önceliklidir; geri çağırma (callback) düzenlemesi API düzeyinde mevcuttur.
Desteklenen sürümlerde özel mod istem/şarkı sözü uzunluğu 5.000 karakterle sınırlıdır.
Vokal cinsiyeti ve vokal özellikleri kesin garanti değil, en iyi çaba (best-effort) kontrolleridir.

Sıkça sorulan sorular

Geliştirmeye başlayın

Yukarıdaki playground'ı deneyin, ardından entegrasyona hazır olduğunuzda API dokümanlarına geçin.

Playground'ı dene API dokümanlarını görüntüle

Suno V5

Örnek çıktılar

Suno API nedir?

Oluşturma İş Akışı Nasıl Çalışır?

Suno API Teknik Özellikler

Çıktılar

Kontrol Yüzeyi

Oluşturma Modları

Teslimat

Temel yetenekler

Çift Kanallı Çıktı

Yaratıcı Kontrol Sürgüleri

Şarkı Sözü ve Vokal İş Akışları

Asenkron Entegrasyona Hazır

Neler inşa edebilirsiniz?

Uygulama İçi Müzik Oluşturma

Podcast ve Video Markalama

Kısa Form İçerik Müzikleri

Oyun ve Etkileşimli Ses

Notlar ve sınırlamalar

Sıkça sorulan sorular

İki yerine sadece tek bir parça oluşturabilir miyim?

Tam şarkı sözü çıktısını zorlayabilir miyim?

Bu API senkron mu?

Hangi dosya türü döndürülür?

Geliştirmeye başlayın