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 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 計費單位 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 計費單位— | 費用 輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
| 設定輸入 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
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 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