ใช้ ElevenLabs Sound Effect V2 ผ่าน Rivya Public API v1 ด้วย model id elevenlabs-sound-effect-v2, input ที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่าง response

พร้อมใช้งานผ่าน APItext input พร้อมเสียง

ID โมเดล API

elevenlabs-sound-effect-v2

Input

text

Files API

ไม่จำเป็นสำหรับ request ขั้นต่ำ

เครดิตพื้นฐาน

ความสามารถ

เสียง

Billing

METERED

ขีดจำกัดพรอมต์

5000 อักขระ

contract ของ request

ส่ง model id ที่ระดับบนสุด control เฉพาะโมเดลอยู่ใน params

Key	Type	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	elevenlabs-sound-effect-v2	ใช้ API model id elevenlabs-sound-effect-v2
prompt	string	ใช่	-	สูงสุด 5000 อักขระสำหรับโมเดลนี้
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	client-side id แบบเลือกได้สำหรับ trace คำขอในระบบของคุณ

พารามิเตอร์โมเดล

Key	Type	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
loop	select	ไม่ใช่	false	-	false, true	ลูป
duration_seconds	number	ไม่ใช่	3	min 0.5 / max 22 / step 0.5	-	ระยะเวลาเป็นวินาที
prompt_influence	number	ไม่ใช่	0.3	min 0 / max 1 / step 0.05	-	อิทธิพลของพรอมป์
output_format	select	ไม่ใช่	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192	รูปแบบเอาต์พุต

request ขั้นต่ำ

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

response จากการสร้าง

endpoint create ส่ง public task id กลับมา poll endpoint สถานะจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_elevenlabs_sound_effect_v2_example",
  "status": "queued",
  "model": "elevenlabs-sound-effect-v2",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

error ทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found