Dùng ElevenLabs Turbo 2.5 qua Rivya Public API v1 với ID mô hình elevenlabs-turbo-2-5, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIĐầu vào văn bản sẵn sàngÂm thanh

ID mô hình API

elevenlabs-turbo-2-5

Đầu vào

text

Files API

Không bắt buộc cho yêu cầu tối thiểu

Tín dụng cơ bản

Năng lực

Âm thanh

Thanh toán

METERED

Giới hạn prompt

5000 ký tự

Quy ước yêu cầu

Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	elevenlabs-turbo-2-5	Dùng elevenlabs-turbo-2-5 làm ID mô hình API.
prompt	string	Có	-	Tối đa 5000 ký tự cho mô hình này.
params	object	Có	-	Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Key	Loại	Bắt buộc	Mặc định	Phạm vi	Tùy chọn	Mô tả
voice	select	Có	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8	Giọng
stability	number	Không	0.5	min 0 / max 1 / step 0.05	-	Độ ổn định
similarity_boost	number	Không	0.75	min 0 / max 1 / step 0.05	-	Tăng độ tương đồng
style	number	Không	0	min 0 / max 1 / step 0.05	-	Phong cách
speed	number	Không	1	min 0.7 / max 1.2 / step 0.05	-	Tốc độ
timestamps	select	Không	false	-	false, true	Dấu thời gian
previous_text	text	Không	-	-	-	Văn bản trước
next_text	text	Không	-	-	-	Văn bản sau
language_code	text	Không	-	-	-	Mã ngôn ngữ

Yêu cầu tối thiểu

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Ngữ cảnh tùy chọn trước dòng này",
    "next_text": "Ngữ cảnh tùy chọn sau dòng này",
    "language_code": "Mã locale tùy chọn như en hoặc zh"
  }
}

Phản hồi tạo

Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.

{
  "id": "task_elevenlabs_turbo_2_5_example",
  "status": "queued",
  "model": "elevenlabs-turbo-2-5",
  "reserved_credits": 6,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found