Suno API：通过一个接口获取提示词和脚本

认证与基础 URL

我们的 API 使用标准的 OpenAI 认证。你只需要一个 API 密钥，你可以在获取 API 密钥页面生成。开始使用不需要电话号码或信用卡；每个新账户都会获得有效期为 7 天的 $0.50 免费试用额度。

在客户端配置中将 base URL 设置为 https://api.sunoapis.com/v1。每次请求必须发送的模型标识符为 uncensored。该开放权重模型托管于我们自有的 GPU 服务器上，专为无需主流提供商常见拒绝机制的合法成人及创意用途而调优。

• 基础 URL： https://api.sunoapis.com/v1
• 模型 ID： uncensored
• 认证头： Authorization: Bearer YOUR_API_KEY

首次请求

立即通过标准的聊天完成请求开始使用。该接口接受包含你的系统提示词、用户指令以及文本转视频或 AI 音乐流水线所需任何元数据的 JSON 负载。

这是一个纯文本 API。它不生成音频、视频或图像；它生成驱动这些工具的文本指令。使用此接口来编写场景脚本、撰写歌词或从创意资产中提取结构化数据。

Copycurl https://api.sunoapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

使用官方 OpenAI SDK 将 API 集成到你的 Python 应用程序中。由于我们兼容 OpenAI，你只需更改基础 URL 和 API 密钥，即可重用现有代码。

这种方法适用于为视频生成工具生成脚本，或为音乐 API 编写元数据。确保你的 SDK 版本是最新的，以支持下一部分中描述的流式输出和函数调用功能。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK

对于 JavaScript/TypeScript 开发者，@anthropic-ai/sdk或官方openai包只需进行少量配置调整即可使用。将客户端指向我们的基础 URL，并使用uncensored模型 ID。

这允许你为创意应用构建服务器端文本生成。你可以使用它来预处理用户输入，或在将生成的脚本发送到音频或视频生成接口之前进行后处理。API 返回与现代化 Web 框架兼容的标准 JSON 响应。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

流式响应

对于长脚本或详细元数据，使用服务器发送事件 (SSE) 实时接收 token。在请求体中设置stream: true。API 将发送一系列数据块，允许你在生成文本时显示它们。

这对于交互式创意工具特别有用，用户希望看到提示词在编写过程中不断演变。每个数据块仅包含增量文本，因此你必须连接片段以重建完整响应。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

限制、错误与上下文

每个账户限用一个 API 密钥，可随时重新生成（撤销旧密钥）。每个密钥每分钟允许 300 次请求，请求体最大 8 MB。

常见错误包括401表示密钥无效，402表示预付额度不足，以及429表示速率限制。该模型支持 100,000 个 token 的上下文窗口，输入和输出合计。

内容说明： 该模型不会拒绝争议性或成人话题，但会严格阻止所有请求中涉及未成年人的性内容。