メインコンテンツへスキップ
POST
音楽を生成
model と prompt を POST /v1/music/generate に送信すると、1 つのリクエスト形式でどの音楽プロバイダーからでもトラックを取得できます。同期型のプロバイダーへの対応や、プロバイダーのキューのポーリングは Phaseo が行います。

結果を読む

完了した生成には audio_url または audio_base64 が含まれます。status は queued、in_progress、completed、failed のいずれかです。まだ最終状態でない場合は、同じ id で GET /v1/music/generate/{music_id} をポーリングしてください。 id は Phaseo の固定のリクエスト ID です。nativeResponseId は上流プロバイダーの識別子で、プロバイダー側との照合やサポートに使います。プロバイダーが生成された長さを報告する場合、usage に output_audio_seconds が含まれます。

Suno のオプションを設定する

Suno のモデルは、任意の suno オブジェクトを受け付けます。 prompt は、customMode が false の場合と、customMode が true で instrumental が false の場合に必須です。 プロバイダーのルールに違反するリクエストは 400 を返します。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
models
string[]

model の後に試行される、任意の順序付きフォールバックモデルです。model は必須で、常にプライマリモデルです。試行が 429、500、502、503、504 で失敗すると次のエントリーが試行され、その他のエラーはそのまま返されます。最大 25 個のモデル ID またはプリセットを指定でき、重複や model と同じエントリーは無視されます。各試行は個別のリクエストとして検証、記録、課金され、レスポンスの model フィールドとルーティングトレースには、リクエストを処理したモデルが表示されます。ストリーミングリクエストは最初のバイトの送信前にのみフォールバックし、動画と音楽のジョブは送信時にのみフォールバックします。Batch、realtime、council のリクエストは models を拒否します。動的ルートで設定されたフォールバックが優先され、phaseo/auto は models と併用できません。

Required array length: 1 - 25 elements
Minimum string length: 1
例:
prompt
string
duration
integer
format
enum<string>
利用可能なオプション:
mp3,
wav,
ogg,
aac
provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

ゲートウェイのデバッグ設定です。これらのフラグがプロバイダーに転送されることはありません。

レスポンス

200 - application/json

音楽生成の応答

id
string
必須

GET /music/generate/{music_id} で使用する、安定した Phaseo リクエスト ID です。

object
enum<string>
必須
利用可能なオプション:
music
status
enum<string>
必須
利用可能なオプション:
queued,
in_progress,
completed,
failed
model
string
必須
provider
string
必須
nativeResponseId
string | null

照合およびサポートに使用する上流プロバイダーの識別子です。

audio_url
string<uri>
audio_base64
string
result
any

Phaseo によって正規化されたプロバイダー結果のメタデータです。

output
object[]
usage
object
最終更新日 2026年11月16日