speech-2.8-turbo
Speech 2.8 Turbo 可快速合成自然語音，支援聲音標記與表現力控制。
- Ailoot · 語音合成
POST /v1/audio/speechspeech-2.8-turbo - Ailoot · 語音合成
POST /v1/audio/speechminimax-speech-turbo
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
快速合成對話台詞
Speech 2.8 Turbo 結合快速音訊生成與自然的語音變化。廠商將 Turbo 定位於流暢對話聲音，包括短台詞、文字配音與語音互動。這份模型說明接受文字並回傳語音音訊。
笑聲、呼吸與語氣詞
如同同世代的 HD 版本，Turbo 支援 Speech 2.8 的聲音標記。文字中可加入笑聲、輕笑、咳嗽、清喉嚨、吸氣、吐氣、嘆息與其他短聲音。這種可控制的變化讓台詞更像對話，加入與內容相關的呼吸和停頓。
聲音標記對應文字中的具體位置，使用模型提供的括號形式，例如 (laughs) 或 (breath)。任意描述效果的文字，不是支援標記的等價替代。
語音與語言
Speech 2.8 系列支援 40 種語言，包括俄文，也能使用現成語音。廠商強調可辨識的聲音質感、呼吸特性與數位失真降低。複製能力屬於語音的獨立準備流程，之後才用於合成。
MiniMax 可選擇語音並調整速度、音量與音高。速度為 0.5–2，音量大於 0 且最高為 10，音高變化為 −12 到 12。情緒可由模型依文字選擇，也可手動指定喜悅、悲傷、憤怒、恐懼、厭惡、驚訝或平靜。
可透過替換詞典及音標調整發音，支援國際音標、漢語拼音與日文讀法。發聲片段之間的停頓範圍為 0.01–99.99 秒，精確到小數點後兩位。標記須放在發聲片段之間，不可連續使用，以便讓名字、縮寫與多義詞的發音符合配音規劃。
逐步輸出與音訊格式
合成接受少於 10 000 個字元的文字。超過 3000 個字元時，廠商建議串流輸出，也提供完整音訊。一般合成設定涵蓋 MP3、PCM、FLAC、WAV、Opus 與 G.711 μ-law，以及單聲道或立體聲；具體請求的可用格式由 Ailoot 提供的功能決定。
Turbo 的速度是模型版本的特性，不是成品台詞具有固定延遲的承諾。這裡未指定這次請求的數值延遲。列出的廠商進階設定，需要 Ailoot 所選呼叫方式支援。
其他音訊設定包括 8、16、22.05、24、32 與 44.1 kHz 的取樣率。MP3 位元率可為 32、64、128 或 256 kbit/s。也可修改音色，使用一種效果：寬闊回音、廳堂回音、電話音色或機器人語音。完整回傳時，變聲效果支援 MP3、WAV 與 FLAC；串流只支援 MP3。G.711 μ-law 採用 8 kHz。這些能力屬於 MiniMax 合成設定。
廠商支援語音與文字同步，提供句子、字詞或逐步輸出字詞的時間標記，以配合發聲與文字顯示。這項額外能力需要相應的回覆格式支援。
Ailoot · 語音合成 POST /v1/audio/speech speech-2.8-turbo
speech-2.8-turbospeech-2.8-turbominimax-speech-turbo
入門
Speech 2.8 Turbo 可快速合成自然語音，支援聲音標記與表現力控制。
- 接受的輸入
- 文字
- 結果
- speech
Ailoot 可用 · 輸入與方法
Ailoot · 語音合成 POST /v1/audio/speech
- 輸入
text- 輸出
speech- 輸出格式
- mp3
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 speech-2.8-turbo | 預設值— |
欄位input | 類型string | 要求必填 | 值與限制 長度下限: 1 長度上限（不含上限值）: 10,000 單位: Unicode 字元 | 預設值— |
欄位voice | 類型string | 要求必填 | 值與限制 模式: ^[A-Za-z0-9_-]{1,128}$ | 預設值— |
欄位response_format | 類型string | 要求選填 | 值與限制 mp3 | 預設值— |
輸入素材組合
text_to_speech · 必填： input
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數material_types | 規格text |
參數required | 規格null |
參數optional_controls | 規格null |
生命週期： 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}
方法結構與 ID 均為精確值；供應商能力與准入狀態分開。
方案
Ailoot 方法費率
POST /v1/audio/speech- 輸入
- US$60.00 每 1 百萬字元
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot · 語音合成
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 narration script}"
export AILOOT_TEXT_FILE
: "${AILOOT_VOICE_ID:?Set the actual accepted voice ID for this model}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "speech-2.8-turbo", "input": ""}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["input"]=text
import re
voice=os.environ["AILOOT_VOICE_ID"]
if not re.fullmatch(r"[A-Za-z0-9_-]{1,128}",voice):raise SystemExit("Set an actual accepted voice ID")
p["voice"]=voice
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 · 語音合成
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
保留完整的二進位結果與標頭。若回傳 JSON 或多個輸出，請保留所有資料項目，並透過每個實際回傳的已簽署資產 URL 取得內容。
需要檢查原始回應時
保留原始 operation_id/X-Client-Request-ID 以供核對，請勿重新提交；沒有專用的音訊輪詢路由。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位binary audio | 類型bytes |
欄位response headers | 類型headers |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、素材表示方式或參數值無效 | 下一步提出新的建立請求前，先修正指定欄位。 |
回應server_error | 條件回傳的回應表示該作業或結果需要檢查 | 下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。 |
別名
模型別名
Ailoot speech-2.8-turbo, minimax-speech-turbo
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
Ailoot · 語音合成 POST /v1/audio/speech minimax-speech-turbo
minimax-speech-turbospeech-2.8-turbominimax-speech-turbo
入門
Speech 2.8 Turbo 可快速合成自然語音，支援聲音標記與表現力控制。
- 接受的輸入
- 文字
- 結果
- speech
Ailoot 可用 · 輸入與方法
Ailoot · 語音合成 POST /v1/audio/speech
- 輸入
text- 輸出
speech- 輸出格式
- mp3
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 minimax-speech-turbo | 預設值— |
欄位input | 類型string | 要求必填 | 值與限制 長度下限: 1 長度上限（不含上限值）: 10,000 單位: Unicode 字元 | 預設值— |
欄位voice | 類型string | 要求必填 | 值與限制 模式: ^[A-Za-z0-9_-]{1,128}$ | 預設值— |
欄位response_format | 類型string | 要求選填 | 值與限制 mp3 | 預設值— |
輸入素材組合
text_to_speech · 必填： input
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數material_types | 規格text |
參數required | 規格null |
參數optional_controls | 規格null |
生命週期： 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}
方法結構與 ID 均為精確值；供應商能力與准入狀態分開。
方案
Ailoot 方法費率
POST /v1/audio/speech- 輸入
- US$60.00 每 1 百萬字元
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot · 語音合成
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 narration script}"
export AILOOT_TEXT_FILE
: "${AILOOT_VOICE_ID:?Set the actual accepted voice ID for this model}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax-speech-turbo", "input": ""}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["input"]=text
import re
voice=os.environ["AILOOT_VOICE_ID"]
if not re.fullmatch(r"[A-Za-z0-9_-]{1,128}",voice):raise SystemExit("Set an actual accepted voice ID")
p["voice"]=voice
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 · 語音合成
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
保留完整的二進位結果與標頭。若回傳 JSON 或多個輸出，請保留所有資料項目，並透過每個實際回傳的已簽署資產 URL 取得內容。
需要檢查原始回應時
保留原始 operation_id/X-Client-Request-ID 以供核對，請勿重新提交；沒有專用的音訊輪詢路由。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位binary audio | 類型bytes |
欄位response headers | 類型headers |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、素材表示方式或參數值無效 | 下一步提出新的建立請求前，先修正指定欄位。 |
回應server_error | 條件回傳的回應表示該作業或結果需要檢查 | 下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。 |
別名
模型別名
Ailoot speech-2.8-turbo, minimax-speech-turbo
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · speech-2.8-turbo
- 可以使用哪些輸入與結果？
POST /v1/audio/speech·speech-2.8-turbo:text→speechPOST /v1/audio/speech·minimax-speech-turbo:text→speech- 請求使用哪些欄位？
POST /v1/audio/speech·speech-2.8-turbo:model,input,voice,response_formatPOST /v1/audio/speech·minimax-speech-turbo:model,input,voice,response_format