API สร้างเสียงเอฟเฟกต์

อัปเดต 2026-09-18 · ทีม Suno-API

คำอธิบายเอนด์พอยต์

การสร้างเสียงเอฟเฟกต์ใช้สร้าง เสียงไม่กี่วินาที ไม่ใช่เพลง เหมาะกับเสียงสั้น ๆ เช่น ฟ้าร้อง หยดฝน เสียงกระแทก และยังใช้ทำเสียงเปลี่ยนฉาก เสียงบรรยากาศ และลูปกลองได้ด้วย ส่วนใหญ่ไม่เกิน 5 วินาที และนานที่สุดราว 20 วินาที รองรับสองโหมดคือ ครั้งเดียว และ ลูป

เอนด์พอยต์: POST /api/music/sounds

ค่าบริการ: มีค่าใช้จ่าย ปัจจุบันค่าเริ่มต้น 0.6 หยวนต่อครั้ง จำนวนที่หักจริงเป็นไปตามการตั้งราคาในระบบหลังบ้านปัจจุบัน

ระยะเวลารอและ timeout (สำคัญ): เอนด์พอยต์นี้เป็นแบบซิงโครนัส — คำสั่งจะถูกรับและส่งเข้าสู่การสร้างเมื่อคำตอบกลับมาเท่านั้น จากการวัด ส่วนใหญ่ตอบกลับภายใน 1-3 วินาที ประมาณ 10% เกิน 30 วินาที และนานที่สุดประมาณ 230 วินาที กรุณาตั้ง timeout ฝั่งไคลเอนต์ไว้ที่ 300 วินาทีขึ้นไป การไม่ได้รับคำตอบไม่ได้หมายความว่าไม่ได้สร้าง และอย่าลองซ้ำทันทีหลัง timeout (จะซ้ำคำสั่งและถูกหักเงินซ้ำ) หากการเชื่อมต่อขาด ให้ตรวจสอบภายหลังด้วย GET /api/music/songs ดูหัวข้อ "ระยะเวลารอและการตั้งค่า timeout" ใน ภาพรวม API ใหม่

พารามิเตอร์คำขอ

Headers

พารามิเตอร์	ชนิด	จำเป็น	หมายเหตุ
Authorization	string	ใช่	Bearer YOUR_API_KEY
Content-Type	string	ใช่	application/json

พารามิเตอร์บอดี

พารามิเตอร์	ชนิด	จำเป็น	ค่าเริ่มต้น	หมายเหตุ
model	string	ไม่	suno-v6	ชื่อโมเดลสำหรับลูกค้า: `suno-v6`, `suno-v6-wild` หรือ `suno-v6-mini`
description	string	ใช่	-	อธิบายเสียงที่ต้องการ วลีสั้นภาษาอังกฤษให้ผลเสถียรที่สุด เช่น `cinematic whoosh transition, bright impact`
title	string	ไม่	-	ชื่อเพลง หากไม่ส่งมาสามารถสร้างจากคำอธิบายได้
type	string	ไม่	one_shot	ประเภท: `one_shot` (ครั้งเดียว) หรือ `loop` (ลูป)
loop	boolean	ไม่	false	จะเล่นวนลูปหรือไม่ เทียบเท่ากับตั้ง `type` เป็น `loop`
bpm	number	ไม่	-	BPM ต้องเป็นตัวเลขมากกว่า 0 ค่าที่ไม่ถูกต้องจะคืน 400 (`invalid_sound_bpm`) ไม่ถูกมองข้ามแบบเงียบ ๆ
key	string	ไม่	-	คีย์ ในรูปแบบชื่อโน้ต (C-B) + `#`/`b` (ถ้ามี) + `Major`/`Minor` (ถ้ามี) เช่น `C Major`, `C#m`, `Bb`; ว่างหรือ `any` หมายถึงไม่จำกัด ค่าที่ไม่ถูกต้องจะคืน 400 (`invalid_sound_key`)

ตัวอย่างคำขอ

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

คำตอบ

คืนค่าอาร์เรย์ของเพลง ฟิลด์เหมือนกับฟิลด์ตอบกลับเพลงทั่วไปใน ภาพรวม API ใหม่

ถัดไปAPI สร้างเนื้อเพลง

รับคีย์ API

สร้างคีย์ API ในคอนโซลหลังสมัครสมาชิก การสร้างหนึ่งครั้งราคา 0.6 หยวน ได้ 2 เพลง ดาวน์โหลดไม่จำกัด และไม่ต้องใช้เบอร์โทรศัพท์

รับคีย์ API กลับไปภาพรวม