Skip to main content
POST
生成音乐
通过统一且不依赖供应商的 API 生成音乐。Phaseo 会在后台处理同步响应并轮询供应商队列。 生成完成后,响应会包含 audio_url 或 audio_base64。如果供应商返回的任务尚未结束,请使用响应中的同一 id 调用 GET /music/generate/{music_id}。

请求结构

Suno 选项

  • suno.customMode (布尔值,默认值为 false)
  • suno.instrumental (布尔值,默认值为 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
必填

稳定的 Phaseo 请求 ID,可与 GET /music/generate/{music_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日