Suno API: Prompts und Skripte über einen Endpunkt

Authentifizierung & Base URL

Unsere API verwendet die Standard-OpenAI-Authentifizierung. Du benötigst nur einen API-Schlüssel, den du auf der API-Schlüssel erhalten-Seite generierst. Keine Telefonnummer oder Kreditkarte ist erforderlich; jedes neue Konto erhält $0,50 kostenloses Testguthaben, das 7 Tage gültig ist.

Setze die Base URL in deiner Client-Konfiguration auf https://api.sunoapis.com/v1. Die Modell-ID, die du in jeder Anfrage senden musst, ist uncensored. Dies ist ein Open-Weight-Modell, das auf unseren eigenen GPU-Servern gehostet wird und für die gesetzeskonforme Nutzung für Erwachsene und kreative Zwecke ohne die typischen Refusals großer Anbieter optimiert ist.

• Base URL: https://api.sunoapis.com/v1
• Modell-ID: uncensored
• Auth-Header: Authorization: Bearer YOUR_API_KEY

Erste Anfrage

Starte sofort mit einer Standard-Chat-Vervollständigungsanfrage. Der Endpunkt akzeptiert JSON-Payloads, die deinen System-Prompt, Benutzeranweisungen und alle für deine Text-zu-Video- oder KI-Musik-Pipeline benötigten Metadaten enthalten.

Dies ist eine Text-only-API. Sie erzeugt kein Audio, Video oder Bilder; sie generiert die Textanweisungen, die diese Tools steuern. Nutze diesen Endpunkt, um Szenarien zu skripten, Texte zu schreiben oder strukturierte Daten aus deinen kreativen Assets zu extrahieren.

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

Integriere die API in deine Python-Anwendungen über das offizielle OpenAI SDK. Da wir OpenAI-kompatibel sind, kannst du deinen bestehenden Code wiederverwenden, indem du einfach die Base URL und den API-Schlüssel änderst.

Dieser Ansatz funktioniert zur Generierung von Skripten für Video-Generierungstools oder zum Schreiben von Metadaten für Musik-APIs. Stelle sicher, dass deine SDK-Version aktuell ist, um die in den nächsten Abschnitten beschriebenen Streaming- und Function-Calling-Funktionen zu unterstützen.

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

Für JavaScript/TypeScript-Entwickler funktionieren das @anthropic-ai/sdk oder das offizielle openai-Paket nach geringfügigen Konfigurationsanpassungen. Richte deinen Client auf unsere Basis-URL und verwende die Modell-ID uncensored.

Dies ermöglicht dir die serverseitige Textgenerierung für deine kreativen Apps. Du kannst dies nutzen, um Benutzereingaben vorzuverarbeiten oder generierte Skripte nachzubearbeiten, bevor sie an deine Audio- oder Video-Generierungsendpunkte gesendet werden. Die API gibt standardmäßige JSON-Antworten zurück, die mit modernen Web-Frameworks kompatibel sind.

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);

Streaming-Antworten

Verwende für lange Skripte oder detaillierte Metadaten Server-Sent Events (SSE), um Token in Echtzeit zu empfangen. Setze stream: true in deinem Request-Body. Die API sendet eine Reihe von Chunks, sodass du Text angezeigt bekommst, während er generiert wird.

Dies ist besonders nützlich für interaktive kreative Tools, bei denen Benutzer sehen möchten, wie sich der Prompt während des Schreibens entwickelt. Jeder Chunk enthält nur den Delta-Text, daher musst du die Fragmente verketten, um die vollständige Antwort zu rekonstruieren.

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)

Limits, Fehler & Kontext

Jedes Konto ist auf einen API-Schlüssel beschränkt, der jederzeit neu generiert werden kann (wobei der alte widerrufen wird). Du darfst 300 Anfragen pro Minute pro Schlüssel senden, mit einer maximalen Request-Body-Größe von 8 MB.

Häufige Fehler sind 401 für ungültige Schlüssel, 402 bei unzureichendem Prepaid-Guthaben und 429 für Ratenlimits. Das Modell unterstützt ein Kontextfenster von 100.000 Token für Input und Output zusammen.

Content Note: Das Modell lehnt kontroverse oder erwachsene Themen nicht ab, blockiert aber strikt sexuellen Inhalt, der Minderjährige betrifft, in allen Anfragen.