音楽モデル
minimax-music-2.6
音楽カタログのモデル ID は minimax-music-2.6 です。モデル一覧から同じ種類のモデルを比較できます。
使用前に確認すること
下の入力表は router が扱う共通パラメータです。すべての設定をこのモデルへ同時に渡せるという意味ではありません。利用するワークスペースのカタログ行で対応入力・値・組み合わせを確認し、対応する設定だけを送信してください。
このページはカタログと入力のスキーマを示します。この種類の生成操作は、現時点の Creative API リファレンスには定義されていません。
入力パラメータ
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
model | string | 任意 | このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。 | 固定値 "minimax-music-2.6" |
prompt | string | 必須 | 生成する内容、または編集で変更したい内容を記述する文章。 | minLength: 1; maxLength: 5000 |
negative_prompt | string | 任意 | 楽曲に含めたくない要素を指示します。 | default: "" |
image_url | string | 任意 | 動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。 | format: "uri" |
metadata | object | 任意 | 利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。 | モデルの capabilities と constraints で確認 |
mode | string | 任意 | async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。 | "async", "sync", "subscribe", "webhook" |
webhook_url | string | 任意 | 終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。 | maxLength: 2048; format: "uri" |
wait_timeout_seconds | integer | 任意 | HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。 | minimum: 0; maximum: 30 |
project_id | string | 任意 | ジョブまたは配置先を関連付けるプロジェクトの ID。 | maxLength: 200 |
duration_seconds | integer | 任意 | 生成する音声や動画の秒数。モデルが指定を受け付ける範囲で選びます。 | minimum: 1; maximum: 600 |
カタログの対応範囲
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
name | string | 必須 | モデル選択画面に表示する名称。要求には名称ではなく id を指定します。 | モデルの capabilities と constraints で確認 |
modality | string | 必須 | 生成されるメディアの種類。音声・音楽モデルは audio を返します。 | "audio" |
routing | string | 必須 | 指定したモデルへ直接送るか、カタログの選択規則で別のモデルへ解決するかを示します。 | "auto", "pass_through" |
resolves_to | string | 任意 | 自動選択の行が現在解決するモデル ID。実行前にカタログで確認します。 | "orchestor/music-auto", "lyria-3.5", "lyria-3-pro", "elevenlabs-music-2.5", "minimax-music-2.6", "lyria-2", "stable-audio-2.5", "ace-step" |
capabilities | object | 必須 | 利用可能な入力や設定の範囲。記載のない設定を要求に追加しないでください。 | 必須の子項目: text_to_music, image_conditioning, lyrics, max_prompt_characters |
capabilities.text_to_music | boolean | 必須 | 文章の指示から楽曲を生成する入力に対応しているかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.image_conditioning | boolean | 必須 | 画像を楽曲生成の参照入力として使用できるかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.lyrics | boolean | 必須 | 歌詞を指定した生成に対応しているかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.max_prompt_characters | integer | 必須 | 楽曲の指示として送れる文章の文字数上限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds | object | 任意 | 指定可能な音声の秒数。項目がない場合はモデルが長さを決めます。 | 必須の子項目: min, max, default |
capabilities.duration_seconds.min | integer | 必須 | 指定できる長さの下限。単位は秒です。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds.max | integer | 必須 | 指定できる長さの上限。単位は秒です。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds.default | integer | 必須 | 長さを省略したときに適用する秒数。 | モデルの capabilities と constraints で確認 |
constraints | (string)[] | 必須 | 文字数、長さ、入力の組み合わせなど、要求が満たす必要のある条件。 | モデルの capabilities と constraints で確認 |
料金の形状
金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
basis | string | 必須 | 単価を適用する生成量の単位。文字数、音声一つ、秒数、分数を区別します。 | "per_audio", "per_second", "per_minute" |
credits_per_audio | integer | 必須 | 一回の音声生成で消費するクレジット。長さによる課金では既定の長さに対する値。 | minimum: 0 |
usd_per_audio | string | 必須 | 一回の音声生成の USD 金額。長さによる課金では既定の長さに対する値。 | pattern: "^\\d+\\.\\d{4,}$" |
credits_per_minute | integer | 任意 | 生成音声 1 分あたりに消費するクレジット。 | minimum: 0 |
usd_per_minute | string | 任意 | 生成音声 1 分あたりの USD 単価。 | pattern: "^\\d+\\.\\d{4,}$" |