speech-2.8-hd
Speech 2.8 HD 可合成具表現力的語音，控制情緒，以及呼吸、笑聲等聲音細節。
- Ailoot · 語音合成
POST /v1/audio/speechspeech-2.8-hd - Ailoot · 語音合成
POST /v1/audio/speechminimax-speech - Ailoot · 語音合成
POST /v1/audio/speechminimax-speech-latest
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
帶有細微聲音的自然語音
Speech 2.8 HD 著重自然、乾淨的聲音。這個世代的主要特性是聲音標記，可在語音中加入對話細節：笑聲、輕笑、呼吸、吸氣、吐氣、嘆息、咳嗽、清喉嚨及其他短聲音。它們有助於呈現自然台詞的節奏與停頓，避免每句話都變成平直的播報。
標記以模型指定的形式放入文字，例如 (chuckle)、(breath) 與 (sighs)，分別代表相應聲音動作。聲音標記是 Speech 2.8 的特定能力，屬於語音合成中的聲音細節，不是另行生成音樂或音效作品。
音色與清晰度
廠商強調語音特性的呈現，包括質感、呼吸與發音方式。系列能力包括使用已準備的複製語音合成；建立這種語音是獨立流程。Speech 2.8 也更新了處理方式，以降低背景雜訊與數位失真。
語言與表現力
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 提供的功能決定。
這份模型說明將文字轉成語音音訊。語音設定描述 MiniMax 模型的能力；語音複製、獨立字幕及特殊連接方式，不會自動包含在配音請求中。
其他音訊設定包括 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-hd
speech-2.8-hdspeech-2.8-hdminimax-speechminimax-speech-latest
入門
Speech 2.8 HD 可合成具表現力的語音，控制情緒，以及呼吸、笑聲等聲音細節。
- 接受的輸入
- 文字
- 結果
- speech
Ailoot 可用 · 輸入與方法
Ailoot · 語音合成 POST /v1/audio/speech
- 輸入
text- 輸出
speech- 輸出格式
- mp3
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 speech-2.8-hd | 預設值— |
欄位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$100.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-hd", "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-hd, minimax-speech, minimax-speech-latest
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
Ailoot · 語音合成 POST /v1/audio/speech minimax-speech
minimax-speechspeech-2.8-hdminimax-speechminimax-speech-latest
入門
Speech 2.8 HD 可合成具表現力的語音，控制情緒，以及呼吸、笑聲等聲音細節。
- 接受的輸入
- 文字
- 結果
- speech
Ailoot 可用 · 輸入與方法
Ailoot · 語音合成 POST /v1/audio/speech
- 輸入
text- 輸出
speech- 輸出格式
- mp3
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 minimax-speech | 預設值— |
欄位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$100.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", "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-hd, minimax-speech, minimax-speech-latest
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
Ailoot · 語音合成 POST /v1/audio/speech minimax-speech-latest
minimax-speech-latestspeech-2.8-hdminimax-speechminimax-speech-latest
入門
Speech 2.8 HD 可合成具表現力的語音，控制情緒，以及呼吸、笑聲等聲音細節。
- 接受的輸入
- 文字
- 結果
- speech
Ailoot 可用 · 輸入與方法
Ailoot · 語音合成 POST /v1/audio/speech
- 輸入
text- 輸出
speech- 輸出格式
- mp3
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 minimax-speech-latest | 預設值— |
欄位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$100.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-latest", "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-hd, minimax-speech, minimax-speech-latest
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · speech-2.8-hd
- 可以使用哪些輸入與結果？
POST /v1/audio/speech·speech-2.8-hd:text→speechPOST /v1/audio/speech·minimax-speech:text→speechPOST /v1/audio/speech·minimax-speech-latest:text→speech- 請求使用哪些欄位？
POST /v1/audio/speech·speech-2.8-hd:model,input,voice,response_formatPOST /v1/audio/speech·minimax-speech:model,input,voice,response_formatPOST /v1/audio/speech·minimax-speech-latest:model,input,voice,response_format