หน้า API ของโมเดล
การเชื่อมต่อ API ของ ElevenLabs Sound Effect V2
ใช้ ElevenLabs Sound Effect V2 ผ่าน Rivya Public API v1 ด้วย model id elevenlabs-sound-effect-v2, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ
พร้อมใช้งานผ่าน APIอินพุตข้อความพร้อมเสียง
ID โมเดล API
elevenlabs-sound-effect-v2
อินพุต
text
Files API
ไม่จำเป็นสำหรับคำขอขั้นต่ำ
เครดิตพื้นฐาน
3
ความสามารถ
เสียง
การชำระเงิน
METERED
ขีดจำกัดพรอมต์
5000 อักขระ
สัญญาของคำขอ
ส่ง model id ที่ระดับบนสุด การควบคุมเฉพาะโมเดลอยู่ใน params
| คีย์ | ประเภท | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|---|
| model | string | ใช่ | elevenlabs-sound-effect-v2 | ใช้ API model id elevenlabs-sound-effect-v2 |
| prompt | string | ใช่ | - | สูงสุด 5000 อักขระสำหรับโมเดลนี้ |
| params | object | ไม่ใช่ | - | object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต |
| client_request_id | string | ไม่ใช่ | - | ID ฝั่งไคลเอนต์แบบเลือกได้สำหรับติดตามคำขอในระบบของคุณ |
พารามิเตอร์โมเดล
| คีย์ | ประเภท | จำเป็น | ค่าเริ่มต้น | ช่วง | ตัวเลือก | คำอธิบาย |
|---|---|---|---|---|---|---|
| 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 | รูปแบบเอาต์พุต |
คำขอขั้นต่ำ
{
"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"
}
}คำตอบจากการสร้าง
endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ 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
}ข้อผิดพลาดทั่วไป
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว