Suno API: prompts en scripts via één endpoint

Authenticatie & Base URL

Onze API gebruikt standaard OpenAI-authenticatie. Je hebt alleen een API-sleutel nodig, die je genereert op de API-sleutel genereren-pagina. Er is geen telefoonnummer of creditcard nodig om te beginnen; elk nieuw account ontvangt $0,50 aan gratis proeftegoed dat 7 dagen geldig is.

Stel de base URL in op https://api.sunoapis.com/v1 in je clientconfiguratie. De model-ID die je in elk verzoek moet verzenden, is uncensored. Dit is een open-weight model gehost op onze eigen GPU-servers, getuned voor wettelijke volwassen en creatieve doeleinden zonder de weigeringen die typisch zijn voor grote aanbieders.

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

Eerste verzoek

Begin direct met een standaard chat-completie-verzoek. De endpoint accepteert JSON-payloads met je system prompt, user instructies en eventuele metadata die nodig is voor je tekst-naar-video- of AI-muziekpipeline.

Dit is een tekst-API. Hij genereert geen audio, video of afbeeldingen; hij genereert de tekstinstructies die die tools aansturen. Gebruik dit endpoint om scènes te scripten, teksten te schrijven of gestructureerde data uit je creatieve assets te halen.

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

Integreer de API in je Python-applicaties met de officiële OpenAI SDK. Omdat we OpenAI-compatibel zijn, kun je je bestaande code hergebruiken door simpelweg de base URL en API-sleutel te wijzigen.

Deze aanpak werkt voor het genereren van scripts voor videogeneratietools of het schrijven van metadata voor muziek-API's. Zorg dat je SDK-versie up-to-date is om de streaming- en function calling-functies te ondersteunen die in de volgende secties worden beschreven.

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

Voor JavaScript/TypeScript-ontwikkelaars werken de @anthropic-ai/sdk of de officiële openai package met kleine configuratieaanpassingen. Wijs je client naar onze base URL en gebruik de model-ID uncensored.

Dit stelt je in staat om serverzijds tekstgeneratie te bouwen voor je creatieve apps. Je kunt dit gebruiken om user inputs voor te verwerken of gegenereerde scripts na te verwerken voordat je ze naar je audio- of video-generatie-endpoints stuurt. De API retourneert standaard JSON-responses compatibel met moderne webframeworks.

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 responses

Gebruik voor lange scripts of gedetailleerde metadata Server-Sent Events (SSE) om tokens in real-time te ontvangen. Stel stream: true in in je request body. De API stuurt een reeks chunks, zodat je tekst kunt weergeven terwijl deze wordt gegenereerd.

Dit is vooral nuttig voor interactieve creatieve tools waar gebruikers de prompt willen zien evolueren terwijl deze wordt geschreven. Elke chunk bevat alleen de delta, dus je moet de fragmenten aan elkaar plakken om de volledige response te reconstrueren.

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)

Limieten, fouten & context

Elk account is beperkt tot één API-sleutel, die op elk moment kan worden geregistreerd (waarbij de oude wordt ingetrokken). Je mag 300 verzoeken per minuut per sleutel doen, met een maximale request body-grootte van 8 MB.

Veelvoorkomende fouten zijn 401 voor ongeldige sleutels, 402 als je onvoldoende prepaid tegoed hebt, en 429 voor rate limits. Het model ondersteunt een contextvenster van 100.000 tokens voor zowel input als output samen.

Content note: Het model weigert controversiële of volwassen onderwerpen niet, maar blokkeert strikt seksuele inhoud met minderjarigen in alle verzoeken.