모델 API 페이지
ElevenLabs Dialogue V3 API 연동
Rivya Public API v1에서 ElevenLabs Dialogue V3을 모델 ID elevenlabs-dialogue-v3, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.
API로 사용 가능텍스트 입력 준비됨Audio
API 모델 ID
elevenlabs-dialogue-v3
입력
text
Files API
최소 요청에는 필요 없음
기본 크레딧
14
기능
Audio
과금
METERED
프롬프트 제한
5000 자
요청 계약
모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.
| Key | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| model | string | 예 | elevenlabs-dialogue-v3 | elevenlabs-dialogue-v3을 API 모델 ID로 사용합니다. |
| prompt | string | 아니요 | - | 이 모델은 최대 5000자까지 사용할 수 있습니다. |
| params | object | 아니요 | - | 모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요. |
| client_request_id | string | 아니요 | - | 자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다. |
| params.dialogue | array | 예 | - | voice와 text를 포함한 객체 배열 형태의 대화 줄입니다. 서버는 이 배열로 작업 프롬프트를 구성합니다. |
모델 파라미터
| Key | 유형 | 필수 | 기본값 | 범위 | 옵션 | 설명 |
|---|---|---|---|---|---|---|
| default_voice | select | 아니요 | Adam | - | Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will | 기본 음성 |
| stability | select | 아니요 | 0.5 | - | 0, 0.5, 1 | 안정성 |
| language_code | text | 아니요 | - | - | - | 언어 코드 |
최소 요청
{
"model": "elevenlabs-dialogue-v3",
"prompt": "A polished audio concept for a short product story",
"params": {
"default_voice": "Adam",
"stability": "0.5",
"dialogue": [
{
"voice": "Adam",
"text": "Welcome to the product walkthrough."
},
{
"voice": "Alice",
"text": "Here is the short version for developers."
}
]
}
}생성 응답
생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.
{
"id": "task_elevenlabs_dialogue_v3_example",
"status": "queued",
"model": "elevenlabs-dialogue-v3",
"reserved_credits": 14,
"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
생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.