tts-1-hd-1106
필수 원고와 voice 값으로 바이너리 오디오를 반환하는 음성 합성입니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
tts-1-hd-1106은 /v1/audio/speech에서 텍스트를 음성으로 바꿉니다. 완성된 제품 시연 내레이션을 input으로 보내고 지원 voice를 선택해 오디오를 저장할 수 있습니다.
model, input, voice는 필수입니다. 이 정확한 항목에는 목소리 enum, 언어 목록, 속도, 형식 선택, 참조 오디오 입력이 게시되지 않았습니다. HD-1106은 신원이며 독립 실측 충실도 우위나 다른 음성 버전 대응을 뜻하지 않습니다. 특정 codec·확장자를 가정하지 말고 반환 content type으로 바이너리를 저장하세요.
Ailoot Ultra · Speech POST /v1/audio/speech tts-1-hd-1106
tts-1-hd-1106시작하기
필수 원고와 voice 값으로 바이너리 오디오를 반환하는 음성 합성입니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Speech POST /v1/audio/speech
- 입력
text- 출력
audio
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 tts-1-hd-1106 조건: 이 Ailoot 라우팅 선택자를 그대로 사용하세요. | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 조건: | 기본값— |
필드voice | 유형string | 요건필수 | 값과 한도 조건: | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input, voice |
매개변수optional | 명세 |
매개변수material_types | 명세text |
매개변수conditions | 명세이 Ailoot 라우팅 선택자를 그대로 사용하세요. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 선택한 라이브러리 기록입니다. operation_id는 별도의 식별자입니다.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 문자 | 요금표— | 과금 단위입력 문자당 | 요금 입력 · 입력 문자 $0.00006 입력 문자당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Speech
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_VOICE:?Set an actual customer material or documented value}"
export AILOOT_VOICE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "tts-1-hd-1106", "input": "Good afternoon! This is a short voice take.", "voice": "YOUR_DOCUMENTED_VOICE"}')
p['voice']=os.environ['AILOOT_VOICE']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.bin
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Speech
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
응답과 헤더 전체, 원래 식별자, 모든 실제 출력 및 모든 사용량/회계 필드를 보존하세요. 고유한 소유 자산을 각각 저장하고 해당 자산을 가리키는 모든 역할을 유지하세요.
원래 응답을 확인해야 할 경우
원래 X-Client-Request-ID, 응답 및 헤더를 보존하세요. 결과를 알 수 없거나 result_pending_check인 경우 두 번째 생성은 허용되지 않습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드binary audio | 유형bytes |
필드response headers | 유형headers |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 모델 선택자, 유형 또는 입력 표현 형식이 유효하지 않습니다. | 다음 단계별도의 요청을 준비하기 전에 반환된 유효성 검사 세부 정보를 확인하세요. |
응답 | 조건원래 요청이나 결과를 알 수 없거나 확인이 필요합니다. | 다음 단계원래 식별자와 헤더를 보존하고, 지원되는 상태 정보나 라이브러리 기록만 조회하세요. 생성 요청을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot Ultra tts-1-hd-1106
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · tts-1-hd-1106
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·tts-1-hd-1106:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·tts-1-hd-1106:model,input,voice