Canopy Labs: Orpheus 3B
Canopy Labs의 미세 조정된 영어 음성 모델 Orpheus 3B는 작성된 문장을 표현력 있는 오디오로 변환합니다. 8개의 사전 설정 목소리와 비언어적 태그를 통해 내레이션, 대화, 애플리케이션의 음성 응답에 활용할 수 있습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Orpheus 3B 0.1 Fine-Tuned는 일상적인 합성을 위한 Canopy Labs의 영어 텍스트 음성 변환 모델입니다. Llama 3B를 기반으로 만든 Orpheus 계열에 속하며 자연스러운 억양, 리듬, 표현력에 중점을 둡니다. 입력은 선택한 화자와 읽을 텍스트이며 출력은 음성 오디오입니다. 제조사는 이 정확한 미세 조정 모델의 기능으로 제로샷 음성 복제도 명시합니다. 공개된 미세 조정 버전의 합성 예제는 사전 설정 화자를 사용하며, 참조 자료를 조건으로 삼는 텍스트·음성 프롬프트 방식은 사전 학습 버전에 대해 별도로 문서화되어 있습니다. 이 미세 조정 버전은 사전 학습 모델 및 따로 공개된 다국어 연구 모델과 구분됩니다.
화자 선택과 대사 준비
제조사는 영어 사전 설정 목소리 8개를 제시합니다. tara, leah, jess, leo, dan, mia, zac, zoe입니다. 프롬프트 규칙은 읽을 텍스트 앞에 화자 이름을 두고 콜론으로 구분하는 방식입니다. 목소리를 따로 제공하는 경우 참조 음성 생성 워크플로에서 이 형식을 추가할 수 있습니다. 작품의 의도에 맞는 화자를 선택하고 이어지는 문단에서도 그 선택을 유지하세요.
짧은 설명에서는 모델에게 설명을 새로 만들라고 지시하지 말고 최종 내레이션을 작성하세요. 예를 들어 “공유할 폴더를 선택하고, 누가 열 수 있는지 확인한 뒤 변경 사항을 저장하세요.”라고 쓸 수 있습니다. 대화에서는 화자별 대사를 명시적으로 준비하고 표현에 도움이 되는 문장부호를 유지하세요. 약어, 날짜, 제품 이름은 청취자에게 들려줄 형태로 써야 하며, 특히 서면 축약 표기가 모호할 때 중요합니다.
표현 및 비언어적 신호
Orpheus 문서는 <laugh>, <chuckle>, <sigh>, <cough>, <sniffle>, <groan>, <yawn>, <gasp> 태그를 설명합니다. 이 태그는 텍스트의 해당 지점에 명시적인 비언어적 사건을 지정합니다. 짧은 대화에서 가벼운 말 앞에 작은 웃음을, 생각에 잠긴 문장 앞에 한숨을 넣을 수 있습니다. 연기에 어울리는 위치에 신호를 사용하고 실제 대사의 단어는 명확하게 유지하세요.
이들은 음성 생성 신호이며 기존 녹음을 편집하는 범용 지시 언어가 아닙니다. 보이스오버에서는 읽기 쉬운 문안으로 시작하고 장면에 필요한 표현만 추가하세요. 전체 대사를 들어 보고 비언어적 사건, 강조, 속도가 의미 전달에 도움이 되는지 판단하세요. 내레이션은 안정적인 목소리가 필요할 수 있고 캐릭터 대사는 특정 비언어적 신호가 도움이 될 수 있습니다.
스트리밍과 오디오 결과
제조사는 비스트리밍 노트북과 스트리밍 음성 예제를 모두 제공합니다. 스트리밍은 문단의 음성이 생성되는 동안 오디오 청크를 순서대로 반환합니다. 공개 예제에서는 이 청크를 24,000 Hz, 16비트 샘플의 모노 WAV 파일에 기록합니다. 이 파일 설정은 참조 워크플로를 설명합니다. 유용한 결과는 단어, 화자, 표현 방식을 대본과 비교할 수 있는 재생 가능한 녹음입니다.
긴 내레이션에는 문장 경계가 분명하고 내용이 이어지는 문단을 준비하고 최종 대본 사본을 오디오와 함께 보관하세요. 각 문단의 시작과 끝, 중요한 이름의 발음, 인접 녹음 사이의 전환을 검토하세요. 제조사의 샘플링 안내는 참조 구현에서 안정적인 생성을 위해 반복 페널티를 최소 1.1로 지정하며 샘플링 선택이 말하기 속도에 영향을 줄 수 있다고 설명합니다. 예제에 설정된 모델 길이는 추론 설정이지 확립된 최대 내레이션 시간이 아닙니다.
버전별 범위
이 소개는 문서에 명시된 사전 설정 화자를 제공하는 미세 조정 영어 모델에 관한 것입니다. 사전 학습 모델에는 자체 텍스트·음성 조건화 워크플로가 있고 다국어 릴리스에는 언어별 화자와 태그가 있습니다. 이 영어 버전을 선택한다고 서로 다른 버전의 특성이 합쳐지지는 않습니다. 실용적인 결과물은 낭독 대본, 의도에 맞게 선택한 사전 설정 목소리, 작품에 필요한 문구와 연기를 충족하는지 검토한 오디오입니다.
Ailoot Ultra · 음성 합성 POST /v1/audio/speech canopylabs/orpheus-3b-0.1-ft
canopylabs/orpheus-3b-0.1-ft시작하기
Canopy Labs의 미세 조정된 영어 음성 모델 Orpheus 3B는 작성된 문장을 표현력 있는 오디오로 변환합니다. 8개의 사전 설정 목소리와 비언어적 태그를 통해 내레이션, 대화, 애플리케이션의 음성 응답에 활용할 수 있습니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 합성 POST /v1/audio/speech
- 입력
text- 출력
audio- 출력 형식
- mp3
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 canopylabs/orpheus-3b-0.1-ft | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 최소 길이: 1 단위: Unicode 문자 | 기본값— |
필드voice | 유형string | 요건필수 | 값과 한도 tara, leah, jess, leo, dan, mia, zac | 기본값— |
필드response_format | 유형string | 요건필수 | 값과 한도 mp3 | 기본값— |
입력 자료 조합
text_to_speech · 필수: input
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input, voice, response_format |
매개변수voice_ids | 명세tara, leah, jess, leo, dan, mia, zac |
매개변수response_format | 명세mp3 |
매개변수max_input_characters | 명세null |
매개변수other_options | 명세false |
매개변수input | 명세정확한 UTF-8 텍스트; 정규화 없이 계산한 유니코드 문자 수 |
매개변수material_types | 명세text |
수명 주기: 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 토큰 |
| 설정Ultra | 요금표— | 과금 대상 수량한자를 포함해 Unicode 코드 포인트 하나를 문자 하나로 계산합니다. | 과금 단위입력 문자 1K개당 | 요금 입력 · 입력 문자 $0.03 입력 문자 1K개당 |
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
Canopy Labs: Orpheus 3B
설정별 가격
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정Canopy Labs: Orpheus 3B · 기본 설정 | 과금 조건기본 설정 | 요금 입력 · 입력 문자 수 US$0.000014 입력 문자당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 음성 합성
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "canopylabs/orpheus-3b-0.1-ft", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["tara", "leah", "jess", "leo", "dan", "mia", "zac"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
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.mp3
결과 수신 및 저장
Ailoot Ultra · 음성 합성
mp3
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 media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
바이너리 결과 전체와 헤더를 보관하세요. JSON 또는 여러 출력이 반환되면 모든 데이터 항목을 보관하고 실제로 반환된 서명된 자산 URL을 각각 조회하세요.
원래 응답을 확인해야 할 경우
다시 제출하지 말고 정산 대조를 위해 최초 operation_id/X-Client-Request-ID를 보관하세요. 전용 오디오 폴링 라우트는 없습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드binary audio | 유형bytes |
필드response headers | 유형headers |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
응답server_error | 조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다 | 다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot Ultra canopylabs/orpheus-3b-0.1-ft
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Canopy Labs: Orpheus 3B
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·canopylabs/orpheus-3b-0.1-ft:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·canopylabs/orpheus-3b-0.1-ft:model,input,voice,response_format