本文へスキップ

クローン用音声をアップロード

クローン手順の第 1 ステップ:録音またはサンプル音声をアップロードし、1 回限り使える `file_id` を取得します。無料です。

POST/v1/files/upload

multipart/form-data で送信し、purpose と file の 2 つのフィールドのみ受け付けます。その他のフィールドは 400 を返します。voice_clone はクローンする録音、prompt_audio は任意のサンプル音声です。形式とサイズはアップロード時に、長さ(voice_clone は 10 秒~5 分、prompt_audio は 8 秒未満)はクローン時に検証します。

ファイルは 1 回しか使えません:クローンに成功すると元の音声とサンプル音声はどちらも自動削除されます。クローンに失敗した場合は保持され、パラメータを変えて再試行できます。アップロードから 24 時間以内に使われなかったファイルは自動削除されます。アップロード済みの音声のダウンロードには対応していません。キーの所属グループに MiniMax の音声モデルが含まれている必要があります。

クローンするのはあなた自身の声、または話者から明示的な書面の許可を得た声に限ってください。

ヘッダー

Authorization:必須string

Bearer sk-…:コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディmultipart

purpose:必須string

voice_clone はクローンする録音、prompt_audio はサンプル音声

取りうる値voice_cloneprompt_audio

file:必須binary

単一のファイル。拡張子は .mp3 / .m4a / .wav、20 MB 以下

レスポンス

200アップロード成功

file:任意object

アップロードしたファイル

base_resp:任意object

成功時は {"status_code": 0, "status_msg": "success"}。エラーはここに入らず、200 以外のステータスコードと error オブジェクトで返されます

エラー

400purpose の値が不正、ファイルが空、非対応の形式、ファイルやフィールドが余分にある
401キー未指定、キーが無効または期限切れ(missing_api_key / invalid_api_key / api_key_expired)
404モデルがこのキーのグループにない(model_not_found)、またはパスがそのグループに属さない(route_not_found)
413リクエストボディが大きすぎる:file exceeds the 20 MiB limit

関連ページ