Free2 indirme API'si

2026-09-18 tarihinde güncellendi · Suno-API ekibi

Uç nokta açıklaması

Free2 ayrı bir ücretli indirme kanalıdır: bir şarkı ID'sinden (veya suno.com şarkı bağlantısından) MP3/WAV/şarkı sözü/üst veri dosyalarını çözümler ve platformda barındırılan indirme adreslerini döndürür. Yalnızca API anahtarını kabul eder, tarayıcı oturumunu kabul etmez ve yanıtta Suno'nun şifreli oynatma kaynağı yer almaz.

Uç nokta: POST /api/music/free2

Faturalama: Başarılı şarkı sayısına göre faturalandırılır, şu an varsayılan olarak şarkı başına 0,2 CNY. Tek istekte birden fazla dosya türü seçmek ek ücret doğurmaz; çözümlenemeyen şarkılar için ücret alınmaz. Tek istekte en fazla 10 şarkı (tekilleştirmeden sonra); gerçekte çekilen tutar arka uçtaki fiyat yapılandırmasına göre belirlenir.

Önerilen model: suno-v6. suno-v6, suno-v6-wild veya suno-v6-mini kullanılabilir.

Kimlik doğrulama

İstek parametreleri

song_id ve song_ids alanlarından en az biri verilmelidir; files en az bir değer içermelidir.

İstek örneği

curl -X POST https://www.suno-api.io/api/music/free2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["song_id_1", "song_id_2"],
    "files": ["mp3", "wav", "lyrics"]
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "songs": [
      {
        "song_id": "song_id_1",
        "files": [
          {"type": "mp3", "url": "https://media.suno-api.io/assets/song_id_1-free2-v1-mp3.mp3"}
        ]
      },
      {
        "song_id": "song_id_2",
        "files": [],
        "error": {"code": "song_not_found", "message": "song not found or not owned by the current user"}
      }
    ],
    "requested_songs": 2,
    "succeeded_songs": 1,
    "price": 0.2
  }
}

Tek şarkı istendiğinde, eski tek şarkılı yazımla uyumluluk için yanıtta ayrıca üst düzey song_id ve files döner.

Önbellekteki adresleri yeniden kullanma (ücretsiz)

Daha önce indirdiğiniz bir şarkıyı yeniden indirmek yeni bir çözümleme gerektirmez ve yeniden ücretlendirilmez: bu hesabın daha önce indirdiği dosyaların güncel adreslerini POST /api/music/free2/cached ile alabilirsiniz.

Uç nokta: POST /api/music/free2/cached

Faturalama: Ücretsiz. Salt okunur bir önbellektir: çözümleme yok, dönüştürme yok, ücret yok; yalnızca hâlihazırda hazır olan ve geri alınmamış adresler döner.

⚠️ İndirme adresinin geçerliliği: 7 gün — zamanında kaydedin. songs[].files[].url platformun nesne depolaması tarafından sunulur ve varsayılan olarak 7 gün sonra geçersiz olur (dosyalar geri alınır ve eski adres 404 döndürür); bu 7 gün içinde kendi depolamanıza kaydedin. Süre dolduktan sonra yeni ve geçerli bir adres almak için POST /api/music/free2 çağrısını yineleyin (bu yeni hazırlık normal ücretlendirme kurallarına tabidir; /api/music/free2/cached yalnızca hâlâ geçerli olan önbellek adreslerini döndürür).

İstek parametreleri: POST /api/music/free2 ile tamamen aynıdır (song_id / song_ids / songs alanlarından herhangi biri ve files içinde en az bir değer).

curl -X POST https://www.suno-api.io/api/music/free2/cached \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "song_ids": ["98ca3f1d-…", "a185b3d9-…"], "files": ["mp3"] }'

{
  "success": true,
  "data": {
    "items": [
      { "song_id": "98ca3f1d-…", "type": "mp3", "url": "https://…/assets/98ca3f1d-…-free2-v1-mp3.mp3" }
    ],
    "songs": [
      { "song_id": "98ca3f1d-…", "files": [ { "type": "mp3", "url": "https://…" } ], "missing_files": [] },
      { "song_id": "a185b3d9-…", "files": [], "missing_files": ["mp3"] }
    ],
    "missing": ["a185b3d9-…"]
  }
}

Adresler yalnızca daha önce indirdiğiniz şarkılar için döner; indirme kaydı olmayan ya da varlıkları geri alınmış şarkılar yalnızca missing içinde görünür ve onlara hiçbir adres döndürülmez.

Notlar

• POST /api/music/free2 Suno'daki herkese açık herhangi bir şarkıyı (bu platformda olmayanlar dahil) çözümleyebilir; bir şarkı çözümlenemediğinde yalnızca o şarkı için error döner ve aynı gruptaki diğer şarkılar etkilenmez. Buna karşılık POST /api/music/free2/cached yalnızca bu hesabın indirdiği şarkılar için adres döndürür.
• Bir şarkının ilk çözümlenmesi barındırılan dosyaları oluşturur ve sonrasında bunlar yeniden kullanılır; files içinde aynı türü tekrar göndermeyin, sunucu tekrarları otomatik olarak kaldırır.
• Şarkı medyası indirme ve önizleme API'si ile farkı: Free2 ücretlidir, doğrudan suno.com bağlantısı göndermeyi destekler ve şarkı sözleri dışında zaman çizelgesi/MIDI türleri sunmaz.