Canopy Labs: Orpheus 3B

Canopy Labs 微調的英語語音模型 Orpheus 3B，能將書面句子轉成富有表現力的音訊。八種預設聲音與非語言標記可用於旁白、對話及應用程式的語音回覆。

Ailoot Ultra · 語音合成 POST /v1/audio/speech canopylabs/orpheus-3b-0.1-ft

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

Orpheus 3B 0.1 Fine-Tuned 是 Canopy Labs 用於日常合成的英語文字轉語音模型。它屬於以 Llama 3B 為骨幹的 Orpheus 系列，著重自然的語調、節奏及富有表現力的發聲。輸入是要朗讀的文字與所選說話者，輸出則是語音音訊。製造商也將零樣本聲音複製列為此一微調模型的能力。其已公開的微調版合成範例使用預設說話者，而以參考內容為條件的文字與語音提示，則另記載於預訓練版本的文件。這個微調版本與預訓練模型，以及另行發布的多語言研究模型各不相同。

選擇說話者並準備台詞

製造商列出八種英語預設聲音：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 /canopylabs/orpheus-3b-0.1-ft

入門

Canopy Labs 微調的英語語音模型 Orpheus 3B，能將書面句子轉成富有表現力的音訊。八種預設聲音與非語言標記可用於旁白、對話及應用程式的語音回覆。

接受的輸入: 文字
結果: 音訊

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 文字；不經正規化的 Unicode 字元計數
參數`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 費率

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定	費率表	應計費數量	計費單位	費用
設定基礎 token 費率	費率表基本費率	應計費數量—	計費單位—	費用輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token
設定Ultra	費率表—	應計費數量每個 Unicode 碼位均計為一個字元，漢字亦同。	計費單位每 1K 個輸入字元	費用輸入 · 輸入字元 $0.03 每 1K 個輸入字元

參考費率詳情

模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。

Canopy Labs: Orpheus 3B

各設定的價格

設定	計費條件	費用
設定Canopy Labs: Orpheus 3B · 預設設定	計費條件預設設定	費用輸入 · 輸入字元數 US$0.000014 每個輸入字元

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot Ultra · 語音合成

curl

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}/content
GET /v1/media/assets
GET /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

方法路徑別名

請使用上方列出的 API 方法路徑。

Canopy Labs: Orpheus 3B