NO.1 API

聊天方式：生成歌曲

POST

/v1/chat/completions

只提供简单的请求示例，更详细的API接口使用说明请阅读官方文档
注意：OpenAI、Claude、Gemini...等聊天模型均使用该接口格式。

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

令牌KEY

必需

示例值:

Bearer sk-xxxx

Body 参数application/json

model

enum<string>

模型名称

必需

枚举值:

suno-v3suno-v3.5

示例值:

suno-v3.5

messages

array [object {2}]

必需

role

string

角色 system | user

必需

content

string

提问消息

必需

stream

boolean

是否流式输出（推荐true）

可选

默认值:

true

示例

{
  "model": "suno-v3.5",
  "messages": [
    {
      "role": "user",
      "content": "生成一首欢快的中文歌曲"
    }
  ],
  "stream": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/chat/completions' \
--header 'Authorization: Bearer sk-xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "suno-v3.5",
    "messages": [
        {
            "role": "user",
            "content": "生成一首欢快的中文歌曲"
        }
    ],
    "stream": true
}'

返回响应

🟢200成功

application/json

Body

string

必需

object

string

必需

created

integer

必需

model

string

必需

choices

array [object {4}]

必需

index

integer

可选

message

object

可选

logprobs

null

可选

finish_reason

string

可选

usage

object

必需

prompt_tokens

integer

必需

completion_tokens

integer

必需

total_tokens

integer

必需

system_fingerprint

string

必需

示例

聊天方式直接返回创作好的两首歌曲

任务：生成歌曲

任务：生成歌词