Skip to main content
POST
音楽を生成
プロバイダーに依存しない1つのAPIで音楽を生成します。Phaseoが同期レスポンスとプロバイダーキューのポーリングをバックグラウンドで処理します。 生成が完了すると、レスポンスにはaudio_urlまたはaudio_base64が含まれます。プロバイダーが未完了のジョブを返した場合は、同じレスポンスのidを使ってGET /music/generate/{music_id}を呼び出してください。

リクエストの形式

Sunoのオプション

  • suno.customMode (boolean、既定値: false)
  • suno.instrumental (boolean、既定値: false)
  • suno.prompt (トップレベルのpromptを任意で上書き)
  • suno.style, suno.title (customMode = trueの場合に必須)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

検証ルール

  • customMode = falseの場合、promptが必要です。
  • customMode = trueの場合、styleとtitleの両方が必要です。
  • customMode = trueかつinstrumental = falseの場合、promptが必要です。
検証エラーは400と次の内容を返します。

応答

  • id は Phaseo の固定リクエスト ID です。GET /music/generate/{music_id} でリクエストを取得できます。
  • nativeResponseId は上流プロバイダーの識別子で、プロバイダーとの照合やサポート時に使用します。
  • status は queued、in_progress、completed、failed のいずれかです。
  • プロバイダーが生成時間を返す場合、usage に output_audio_seconds が含まれることがあります。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
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年10月2日