API muat naik audio sumber

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Muat naik audio sumber menukar fail audio setempat atau jauh menjadi klip sumber yang boleh digunakan oleh keupayaan seterusnya: cover, pemanjangan, penggantian bahagian, pemisahan dan lain-lain.

Endpoint: POST /api/music/upload-source

Pengebilan: Percuma. Endpoint ini hanya memuat naik audio sumber; ia tidak memulakan tugasan penjanaan.

Penggunaan yang disyorkan: ini langkah 1 bagi «cover dua langkah». Muat naik audio dahulu dengan endpoint ini (percuma, dan boleh cuba semula bila-bila gagal) dan simpan clip_id yang dipulangkan; selepas mengesahkan muat naik berjaya (status dalam keadaan selesai), panggil API cover daripada klip sumber untuk memulakan cover — badan permintaan itu hanya beberapa ratus bait, jadi ia tidak boleh terpotong semasa penghantaran kerana audio terlalu besar. Berbanding API sekali gus muat naik lalu cover, pemisahan ini lebih kukuh apabila audio besar, rangkaian tidak stabil, atau bahan yang sama akan digunakan semula beberapa kali (pemanjangan / penggantian / pemisahan).

Petua untuk muat naik fail besar

Selepas muat naik selesai, sentiasa pastikan status dalam respons sudah berkeadaan selesai dan simpan clip_id sebelum ke langkah 2; muat naik yang gagal tidak dicaj dan tidak mencipta tugasan penjanaan — cuba semula sahaja.

Parameter permintaan

Headers

Untuk permintaan JSON:

Jangan tetapkan Content-Type secara manual untuk permintaan multipart; klien menjananya secara automatik.

Parameter body

Contoh permintaan JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

Contoh permintaan multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

Respons

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}