跳转到主要内容
POST
生成音乐
将 model 和 prompt 发送到 POST /v1/music/generate,即可用同一种请求格式从任意音乐提供商获得一首曲目。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 对象: 当 customMode 为 false 时,以及当 customMode 为 true 且 instrumental 设为 false 时,prompt 为必填项。 违反提供商规则的请求会返回 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
必填

稳定的 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年11月16日