Source: https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/ Canonical: https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/ Language: zh-hant-tw # Fish Audio: Drama 3 [Markdown](https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/facts.json) ## [Fish Audio: Drama 3](https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/) Drama 3 將書面腳本轉成經過演出指導的語音。可用自然語言提示塑造情緒與表達方式、加入停頓和聲音、指導發音，並建立多位說話者的場景。公開的語音流程支援超過 80 種語言，包括在同一句話中切換語言。 - [**Ailoot Ultra · 語音** `POST /v1/audio/speech` `fish-audio/drama-3`](https://ailoot.ai/models/zh-hant-tw/fish-audio-drama-3/#method-0) 關於模型 此說明介紹模型的能力。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`](https://ailoot.ai/models/zh-hant-tw/#m=fish-audio%2Fdrama-3&route=Ultra&caller=fish-audio%2Fdrama-3&fmt=speech) Fish Audio /`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 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) ### 請求範例 #### Ailoot Ultra · 語音 使用實際輸入並保留完整結果 ```bash 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}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` 其他內容讀取方式 讀取現有且屬於自己的素材 ```bash 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`](https://ailoot.ai/models/zh-hant-tw/#m=fish-audio%2Fdrama-3&route=Ultra&caller=fish-audio%2Fdrama-3&fmt=speech) #### 方法路徑別名 請使用上方列出的 API 方法路徑。 #### 相關呼叫用 ID [`fish-audio/drama-3`](https://ailoot.ai/models/zh-hant-tw/#m=fish-audio%2Fdrama-3&route=Ultra&caller=fish-audio%2Fdrama-3&fmt=speech) 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` 將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。 ## 公司及其專案組合 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 ## 優惠購買 token。 訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。 訂閱 為定期請求選擇優惠方案。 最高 50% 折扣碼 購買時輸入代碼，價格依活動重算。 歷史中的費用 每次請求保存模型、token 與金額。 [選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/) ## 將 API 加入 你銷售的產品。 依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。 商用應用程式 在付費功能加入文字、圖片、影片與聲音生成。 經銷授權 提供專案說明與存取方式，要求書面使用和轉售條件。 網站文件 串接前可閱讀正式服務條款、授權合約與資料處理政策。 [申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw) ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。