MiniMax Speech 2.8 HD
統合
モデルID
minimax/speech-2.8-hd
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/minimax/speech-2.8-hd?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view.",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/minimax/speech-2.8-hd", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/ja/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "minimax/speech-2.8-hd",
"input": {
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}
}
Doitong APIを通じてMiniMax Speech 2.8 HDモデル(minimax/speech-2.8-hd)を呼び出します。エージェント向けドキュメント: https://doitong.com/ja/developers/models/minimax/speech-2.8-hd.md
POST https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}
レスポンスのステータスが"queued"または"running"の場合、"succeeded"になるまでGET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20をポーリングしてください。ファイルはoutputs[].urlにあります。同じボディでPOST https://api.doitong.com/v1/quote/minimax/speech-2.8-hdを実行すると、実行前の正確な価格が返されます。
このリクエスト: $0.019 19 APIクレジット このページで実行
新しいAPIキーです。 これは今だけ表示され、コードと下記のAPIキー欄にすでに入力されています。秘密にしてください。ブラウザで実行されるコードに決して含めないでください。
例
リクエストを作成
コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。
POST
/run/minimax/speech-2.8-hd?wait=20
見積もり → $0.019
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/minimax/speech-2.8-hd?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view.",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/minimax/speech-2.8-hd", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "minimax/speech-2.8-hd",
"input": {
"prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
},
"wait_seconds": 20
}
}
}
MiniMax Speech 2.8 HDについて
MiniMax Speech 2.8 HDは、30以上の言語でテキストを音声化し、インラインポーズマーカー、音声の速度、ピッチ、音量、カスタム発音辞書、音声効果を細かく制御できます。 内蔵音声と出力のサンプルレートおよび形式を選択できます。
パラメータ
名前型
デフォルト許可される値
説明
prompt必須
型string
≤ 10,000文字
音声合成用テキスト。`<#x#>` で一時停止を指定し、x は 0.01~99.99 秒の範囲です。使用できる間投詞タグは `(laughs)`、`(sighs)`、`(coughs)`、`(clears throat)`、`(gasps)`、`(sniffs)`、`(groans)`、`(yawns)` です。
voice_setting任意
型object
デフォルト{"english_normalization":false,"pitch":0,"speed":1,"voice_id":"Wise_Woman","vol":1}
音声を設定するための設定。
voice_setting.voice_id任意
型string
デフォルトWise_Woman
≥ 1 characters
音声合成に使用する定義済み音声識別子。
voice_setting.speed任意
型number
デフォルト1
0.5 – 2
話速。0.5~2.0の範囲です。
voice_setting.vol任意
型number
デフォルト1
0.01 – 10
出力音量。0~10の範囲です。
voice_setting.pitch任意
型integer
デフォルト0
-12 – 12
音声のピッチ。-12~12の範囲です。
voice_setting.emotion任意
型enum
happysadangryfearfuldisgustedsurprisedneutral
合成音声の感情的なトーン。
voice_setting.english_normalization任意
型boolean
デフォルトfalse
英語テキストの正規化オプション。追加の遅延が少し発生する代わりに、数字の読み上げを改善します。
audio_setting任意
型object
音声を設定するための設定。
audio_setting.sample_rate任意
型enum
デフォルト32000
80001600022050240003200044100
生成音声のサンプリングレート。
audio_setting.bitrate任意
型enum
デフォルト128000
3200064000128000256000
生成音声のビットレート。
audio_setting.format任意
型enum
デフォルトmp3
mp3pcmflac
音声の形式。
audio_setting.channel任意
型enum
デフォルト1
12
音声チャンネル数。モノラルは1、ステレオは2です。
language_boost任意
型enum
ChineseChinese,YueEnglishArabicRussianSpanishFrenchPortugueseGermanTurkishDutchUkrainianVietnameseIndonesianJapaneseItalian
さらに22件
KoreanThaiPolishRomanianGreekCzechFinnishHindiBulgarianDanishHebrewMalaySlovakSwedishCroatianHungarianNorwegianSlovenianCatalanNynorskAfrikaansauto選択した言語と方言の認識を改善します。
output_format任意
型enum
デフォルトhex
urlhex
出力コンテンツの形式。非ストリーミングレスポンスにのみ適用されます。
pronunciation_dict任意
型object
テキストの置換に使用する発音のカスタム辞書。
pronunciation_dict.tone_list任意
型string[]
['text/(pronunciation)', ...] の構文を使用する発音置換リスト。例: ['燕少飞/(yan4)(shao3)(fei1)']。中国語の声調番号は1~5です。
normalization_setting任意
型object
音声のラウドネス正規化を制御する設定。
normalization_setting.enabled任意
型boolean
デフォルトtrue
音声のラウドネス正規化を有効にします。
normalization_setting.target_loudness任意
型number
デフォルト-18
-70 – -10
LUFS単位の目標ラウドネス。デフォルトは -18.0 です。
normalization_setting.target_range任意
型number
デフォルト8
0 – 20
LU単位の目標ラウドネス範囲。デフォルトは 8.0 です。
normalization_setting.target_peak任意
型number
デフォルト-0.5
-3 – 0
dBTP単位の目標ピークレベル。デフォルトは -0.5 です。
voice_modify任意
型object
声の高さ、強度、音色を変更する設定。
voice_modify.pitch任意
型integer
デフォルト0
-100 – 100
半音単位のピッチ制御。負の値で声を低くし、正の値で高くします。指定可能な値は -100~100 です。
voice_modify.intensity任意
型integer
デフォルト0
-100 – 100
音声のエネルギーを制御します。設定値が高いほど発話がよりエネルギッシュになります。範囲は -100~100 です。
voice_modify.timbre任意
型integer
デフォルト0
-100 – 100
-100~100 の範囲で声の音色を調整し、音質を制御します。
必須
出力
GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "minimax/speech-2.8-hd",
"status": "succeeded",
"created_at": "2026-10-20T12:00:00Z",
"started_at": "2026-10-20T12:00:02Z",
"completed_at": "2026-10-20T12:00:09Z",
"queue_position": null,
"cost": {
"credits": 19,
"usd": "0.019",
"charged": 19,
"refunded": 0
},
"input": {
"prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
},
"output": {
"audio": {
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
"content_type": "audio/mpeg",
"file_name": "0-output.mp3",
"file_size": 1843200
},
"duration_ms": 1
},
"outputs": [
{
"type": "audio",
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
"content_type": "audio/mpeg",
"file_size": 1843200,
"duration": 12,
"stored": true
}
],
"error": null,
"metrics": {
"inference_seconds": 6.8
},
"urls": {
"self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}
ファイルの保存期間を選択すべてのoutputs[].urlはストレージ上のコピーです。アカウント設定または?storage=により、永久保存(GB・月単位で有料)または無料で7日保存できます。
すべてのモデルで同じ形式画像、動画、音声のいずれでも、type、url、content_type、width、height、durationが含まれます。outputはモデル独自の結果オブジェクトです。
出力フィールド
- audio
- object {url, content_type, file_name, file_size}生成によって作成された音声ファイル。
- duration_ms
- integerミリ秒単位の音声の長さ。
その他のMiniMax Speechバリアント
その他のモデル: テキスト読み上げ
AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/minimax/speech-2.8-hd.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt