音楽モデル

orchestor/music-auto

音楽カタログのモデル ID は orchestor/music-auto です。モデル一覧から同じ種類のモデルを比較できます。

使用前に確認すること

下の入力表は router が扱う共通パラメータです。すべての設定をこのモデルへ同時に渡せるという意味ではありません。利用するワークスペースのカタログ行で対応入力・値・組み合わせを確認し、対応する設定だけを送信してください。

このページはカタログと入力のスキーマを示します。この種類の生成操作は、現時点の Creative API リファレンスには定義されていません。

入力パラメータ

フィールド型指定意味値と制約
modelstring任意このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。固定値 "orchestor/music-auto"
promptstring必須生成する内容、または編集で変更したい内容を記述する文章。minLength: 1; maxLength: 5000
negative_promptstring任意楽曲に含めたくない要素を指示します。default: ""
image_urlstring任意動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。format: "uri"
metadataobject任意利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。モデルの capabilities と constraints で確認
modestring任意async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。"async", "sync", "subscribe", "webhook"
webhook_urlstring任意終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。maxLength: 2048; format: "uri"
wait_timeout_secondsinteger任意HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。minimum: 0; maximum: 30
project_idstring任意ジョブまたは配置先を関連付けるプロジェクトの ID。maxLength: 200
duration_secondsinteger任意生成する音声や動画の秒数。モデルが指定を受け付ける範囲で選びます。minimum: 1; maximum: 600

カタログの対応範囲

フィールド型指定意味値と制約
namestring必須モデル選択画面に表示する名称。要求には名称ではなく id を指定します。モデルの capabilities と constraints で確認
modalitystring必須生成されるメディアの種類。音声・音楽モデルは audio を返します。"audio"
routingstring必須指定したモデルへ直接送るか、カタログの選択規則で別のモデルへ解決するかを示します。"auto", "pass_through"
resolves_tostring任意自動選択の行が現在解決するモデル 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"
capabilitiesobject必須利用可能な入力や設定の範囲。記載のない設定を要求に追加しないでください。必須の子項目: text_to_music, image_conditioning, lyrics, max_prompt_characters
capabilities.text_to_musicboolean必須文章の指示から楽曲を生成する入力に対応しているかを示します。モデルの capabilities と constraints で確認
capabilities.image_conditioningboolean必須画像を楽曲生成の参照入力として使用できるかを示します。モデルの capabilities と constraints で確認
capabilities.lyricsboolean必須歌詞を指定した生成に対応しているかを示します。モデルの capabilities と constraints で確認
capabilities.max_prompt_charactersinteger必須楽曲の指示として送れる文章の文字数上限。モデルの capabilities と constraints で確認
capabilities.duration_secondsobject任意指定可能な音声の秒数。項目がない場合はモデルが長さを決めます。必須の子項目: min, max, default
capabilities.duration_seconds.mininteger必須指定できる長さの下限。単位は秒です。モデルの capabilities と constraints で確認
capabilities.duration_seconds.maxinteger必須指定できる長さの上限。単位は秒です。モデルの capabilities と constraints で確認
capabilities.duration_seconds.defaultinteger必須長さを省略したときに適用する秒数。モデルの capabilities と constraints で確認
constraints(string)[]必須文字数、長さ、入力の組み合わせなど、要求が満たす必要のある条件。モデルの capabilities と constraints で確認

料金の形状

金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。

フィールド型指定意味値と制約
basisstring必須単価を適用する生成量の単位。文字数、音声一つ、秒数、分数を区別します。"per_audio", "per_second", "per_minute"
credits_per_audiointeger必須一回の音声生成で消費するクレジット。長さによる課金では既定の長さに対する値。minimum: 0
usd_per_audiostring必須一回の音声生成の USD 金額。長さによる課金では既定の長さに対する値。pattern: "^\\d+\\.\\d{4,}$"
credits_per_minuteinteger任意生成音声 1 分あたりに消費するクレジット。minimum: 0
usd_per_minutestring任意生成音声 1 分あたりの USD 単価。pattern: "^\\d+\\.\\d{4,}$"