Fish Audio: Drama 3
Drama 3는 작성된 대본을 연출된 음성으로 바꿉니다. 자연어 지시로 감정과 표현 방식을 조절하고, 멈춤과 소리를 추가하며, 발음을 안내하고 여러 화자의 장면을 구성할 수 있습니다. 공개된 음성 워크플로는 문장 안에서의 언어 전환을 포함해 80개가 넘는 언어를 지원합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Drama 3는 대본을 연기하듯 읽기 위한 Fish Audio의 텍스트 음성 변환 모델입니다. 제공한 단어로 음성 오디오를 만들며 대본 작성자가 표현 방식을 제어할 수 있게 합니다. 한 대사에 감정 지시, 국소적인 음성 연기 변화, 발음 지시를 담을 수 있으므로 입력에는 발화 내용과 원하는 소리 표현이 함께 포함됩니다.
말을 작성하고 연기를 지시하세요
연기 지시를 추가하기 전에 청자가 듣기를 원하는 정확한 말을 준비하세요. 중요한 이름, 날짜, 지시를 대본에 명확하게 유지하고 문장부호로 의도한 문장 리듬을 설정하세요. 그런 다음 해당 대사 앞에 자연어 지시를 대괄호로 넣으세요. 절제된 안내, 긴장된 대화, 따뜻한 설명처럼 원하는 감정이나 표현 방식을 구체적으로 설명하세요.
Drama 3는 대사 안의 국소적인 제어도 지원합니다. 인라인 지시로 소리와 멈춤을 넣을 수 있으며, 쌍으로 된 표현 태그로 특정 단어에 영향을 줄 수 있습니다. 각 지시의 범위를 명확하게 하세요. 한 구절의 지시가 의도치 않게 장면 전체에 적용되지 않도록 하는 것이 좋습니다. 합성하기 전에 대본을 의미 중심으로 한 번, 연기 중심으로 한 번 읽어 보세요.
장면, 언어, 발음
공개된 모델은 하나의 요청 안에서 여러 화자를 지원합니다. 대화를 명확한 화자별 턴으로 구성하고 각 턴에 질문, 끼어들기, 설명, 응답 같은 목적을 부여하세요. 수업이나 설명 콘텐츠에서는 같은 방식으로 내레이터와 인용된 등장인물을 구분할 수 있으며, 자료를 구분 없는 하나의 독백으로 재작성할 필요가 없습니다.
Drama 3는 80개가 넘는 언어를 지원하고 목소리를 유지하면서 문장 안에서 언어를 바꿀 수 있습니다. 영어 지시가 번역까지 제공한다고 가정하지 말고, 다국어 구절을 실제로 발화할 언어로 준비하세요. 외국 이름과 차용어의 원하는 발음을 정하고, 발음에 정밀한 지시가 필요할 때 모델의 음소 제어를 사용하세요.
유용한 오디오 결과물
이 모델은 등장인물 대화, 내레이션 수업, 짧은 설명, 제품 안내, 대본 기반 음성 응답에 적합합니다. 내용과 연기 선택을 함께 유지하세요. 교육용 구절에는 알아듣기 쉬운 용어와 목적 있는 멈춤이 필요하고, 등장인물 장면에는 명확히 구분된 턴과 일관된 극적 의도가 필요합니다. 이는 오디오가 생성되기 전에 검토할 수 있는 글쓰기 결정입니다.
합성 후에는 발화된 말을 완성된 대본과 비교하세요. 빠진 구절, 잘못 배치된 멈춤, 불명확한 화자 전환, 보존해야 할 이름의 발음을 확인하며 들어 보세요. 문제가 있는 대사를 대상으로 수정할 수 있도록 대본과 표현 지시를 오디오와 함께 유지하세요. 개정할 때는 최종 발화 내용과 대사별 연기 선택을 함께 유지하세요.
기능
- 완성된 대본을 바탕으로 한 텍스트 음성 변환 연기.
- 대사 앞에 대괄호로 넣는 자연어 지시.
- 인라인 소리와 멈춤, 특정 단어에 적용하는 쌍으로 된 표현 태그.
- 여러 화자의 장면과 80개가 넘는 발화 언어.
- 이름과 전문 용어를 위한 음소 제어.
활용 사례
- 등장인물 대화 — 화자별 턴과 연기 지시가 명확히 구분된 대본. 결과: 표현 방식이 의도적으로 바뀌는 음성 장면.
- 내레이션 설명 — 용어와 멈춤을 표시한 완성된 수업. 결과: 수업 텍스트와 대조해 검토할 수 있는 음성 오디오.
- 다국어 안내 — 의도한 언어로 작성하고 발음 선택을 유지한 최종 텍스트. 결과: 언어 전환이 제어된 발화 구절.
- 대본 기반 음성 응답 — 명시적인 어조와 발화할 말을 담은 간결한 응답. 결과: 주변 애플리케이션에서 재사용할 수 있는 음성 구간.
제한
- 입력과 결과 — 공개된 모델은 텍스트를 입력받아 음성 오디오를 반환합니다.
- 제어 범위 — 의도한 대사나 구절에 지시를 연결하고 쌍으로 된 표현 태그의 범위를 적절하게 유지하세요.
- 검토 단위 — 정확한 대본과 지시를 오디오와 함께 유지하고 대사별로 발음과 화자 턴을 검토하세요.
Ailoot Ultra · 음성 POST /v1/audio/speech fish-audio/drama-3
fish-audio/drama-3시작하기
Drama 3는 작성된 대본을 연출된 음성으로 바꿉니다. 자연어 지시로 감정과 표현 방식을 조절하고, 멈춤과 소리를 추가하며, 발음을 안내하고 여러 화자의 장면을 구성할 수 있습니다. 공개된 음성 워크플로는 문장 안에서의 언어 전환을 포함해 80개가 넘는 언어를 지원합니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 POST /v1/audio/speech
- 입력
text- 출력
audio
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 fish-audio/drama-3 | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
필드voice | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 mp3, pcm | 기본값pcm |
필드provider | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input, voice |
매개변수material_types | 명세text |
매개변수material_conditions | 명세실제로 지원되는 음성 ID를 선택하세요. 이 모델에 대해 리터럴 기본값/음성을 임의로 설정하지 않았습니다. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 UTF-8 바이트 | 요금표— | 과금 단위입력 UTF-8 바이트당 | 요금 입력 · 입력 UTF-8 바이트 $0.00002 입력 UTF-8 바이트당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 음성
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_TEXT:?Set the actual documented input value}"
export AILOOT_INPUT_TEXT
: "${AILOOT_VOICE:?Set the actual documented input value}"
export AILOOT_VOICE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'fish-audio/drama-3', 'input': '${ACTUAL_INPUT_TEXT}', 'voice': '${ACTUAL_SUPPORTED_VOICE}'}
request['input']=os.environ['AILOOT_INPUT_TEXT']
request['voice']=os.environ['AILOOT_VOICE']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
결과 수신 및 저장
Ailoot Ultra · 음성
바이너리 오디오 전체 또는 원래 audio_url 응답, 헤더 및 모든 소유 자산입니다.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요.
별칭
모델 별칭
Ailoot Ultra fish-audio/drama-3
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Fish Audio: Drama 3
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·fish-audio/drama-3:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·fish-audio/drama-3:model,input,voice,response_format,provider