OpenAI-호환 TTS
Tavo 및 기타 OpenAI 호환 음성 클라이언트를 Kitta Audio TTS에 연결합니다.
OpenAI-호환 TTS
클라이언트가 OpenAI POST /v1/audio/speech 계약을 기대하는 경우 이 엔드포인트를 사용하세요. 이는 Tavo의 Custom OpenAI 프로토콜 TTS 공급자와 같은 통합을 위한 것입니다.
전체 요청 계약과 기본 Kitta Audio 통합의 경우 Sync HTTP를 사용하세요.
엔드포인트
POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json전체 URL:
https://fishaudio.org/v1/audio/speechAPI 키를 신뢰할 수 있는 서버나 타사 공급자의 보호되는 API 자격 증명 필드에 보관하세요. 각 고객 또는 통합에 대해 별도의 키를 생성하여 독립적으로 모니터링하고 취소할 수 있습니다.
요구
{
"model": "fishaudio-s21pro-flash",
"input": "Hello from Kitta Audio.",
"voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
"response_format": "mp3",
"speed": 1
}| 필드 | 유형 | 필수 | 메모 |
|---|---|---|---|
model | 문자열 | 예 | Kitta Audio 엔진 모델 ID(예: fishaudio-s21pro-flash) |
input | 문자열 | 예 | 합성할 텍스트 |
voice | 문자열 또는 객체 | 예 | 음성 ID 문자열 또는 { "id": "00a1b221-6137-4b73-ad62-b0cbce134167" } |
response_format | 문자열 | 아니요 | mp3, wav 또는 pcm; 기본값은 mp3 |
speed | 번호 | 아니요 | 0.5에서 2까지의 말하기 속도; 기본값은 1 |
GET /api/open/v1/voices에서 음성 ID를 가져옵니다. 빠른 연결 테스트를 위해서는 공용 시스템 음성 00a1b221-6137-4b73-ad62-b0cbce134167를 사용하세요. 지원되는 Kitta Audio TTS 모델 ID를 사용하세요. tts-1와 같은 OpenAI 모델 이름은 Kitta Audio 모델의 별칭이 아닙니다.
일부 타사 클라이언트는 OpenAI 호환 음성 목록을 통해 음성을 검색합니다. 다음으로 전화할 수 있습니다.
GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY음성 요청에서 반환된 voices[].id 값을 voice로 사용합니다.
응답
성공적인 요청은 바이너리 오디오를 반환합니다.
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12
<binary audio data>클라이언트는 Content-Type에 따라 응답을 저장하거나 재생해야 합니다. 오류는 JSON 응답이며 기본 동기화 엔드포인트와 동일한 인증, 할당량 및 생성 동작을 사용합니다.
curl 예
curl -X POST "https://fishaudio.org/v1/audio/speech" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "fishaudio-s21pro-flash",
"input": "Hello from Kitta Audio.",
"voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
"response_format": "mp3",
"speed": 1
}' \
--output speech.mp3타보 연결
API 키, 기본 URL, 모델, 음성 및 문자 바인딩 설정은 전용 Kitta Audio TTS for Tavo 가이드를 따르세요.
오류
| 상태 | 의미 | 액션 |
|---|---|---|
400 | 잘못된 입력, 음성, 모델, 형식 또는 속도 | 재시도하기 전에 요청을 수정하세요. |
401 | API 키가 없거나 잘못되었습니다. | 통합 키 확인 또는 교체 |
402 | API 할당량이 부족합니다 | 더 많은 오디오를 생성하기 전에 할당량 추가 |
429 | 요청 비율 제한을 초과했습니다 | 지수 백오프로 재시도 |
500 | TTS 생성 실패 | 중복 청구를 인식한 경우에만 재시도 |