跳转到主要内容
POST
Create a media task
能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务;音乐积分扣除当前未启用。

请求

发送 model 和 input 对象;按模型 Schema 将可选 output_count、fallback 放在 input 内。callback_url 是可选的顶层公网 HTTPS 地址。不使用 max_credits、报价步骤或提交幂等键。 每次成功受理都创建新任务。网络超时后重发可能产生另一单和另一笔费用;已配置启用的 Suno 操作创建持久化任务;未启用操作返回 50301 且不创建任务。

受理响应

已启用模型成功受理后返回 HTTP 200,data 中包含 task_id;受理不代表生成成功。未启用操作返回 HTTP 503、code 50301,且不创建任务。

授权

Authorization
string
header
必填

Every valid key can submit and query its own account. Revoked keys are rejected.

请求体

application/json
model
string
必填
示例:

"prism-image-2"

input
object
必填

Validate against the selected model input_schema. output_count/fallback are optional model-specific input fields; never top-level.

示例:
callback_url
string<uri>

Optional public HTTPS endpoint for signed completion callbacks; no redirects or private IPs.

响应

Accepted task. Poll the common task endpoint or use callback_url.

code
any
必填
msg
any
必填
data
object
必填