Suno API：透過單一端點處理提示詞與腳本

驗證與 Base URL

我們的 API 使用標準 OpenAI 驗證機制。您只需要一個 API 金鑰，可在取得 API 金鑰頁面建立。無需電話號碼或信用卡即可開始；每個新帳戶都會獲得 $0.50 的免費試用額度，有效期為 7 天。

在您的客戶端設定中，將基礎 URL 設為 https://api.sunoapis.com/v1。您在每個請求中必須使用的模型識別符為 uncensored。此為託管於我們自有 GPU 伺服器上的開放權重模型，針對合法成人與創意用途進行微調，可避免大型供應商常見的拒絕回應。

• Base 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 相容，你可以重複使用現有程式碼，只需更改 Base 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套件經過少量設定調整即可使用。將你的客戶端指向我們的 Base URL，並使用uncensored模型 ID。

這允許你為創意應用程式建立伺服器端文字生成。你可以使用它來預處理使用者輸入，或在將產生的腳本傳送給音訊或影片生成端點之前進行後處理。API 回傳標準 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 的上下文視窗，適用於輸入與輸出的總和。

內容注意事項： 該模型不會拒絕爭議性或成人主題，但會嚴格禁止所有請求中包含涉及未成年人的性內容。