API Suno: prompt e script su un singolo endpoint

Autenticazione e Base URL

La nostra API utilizza l'autenticazione standard di OpenAI. Hai bisogno solo di una chiave API, che generi nella pagina Ottieni chiave API. Non sono richiesti numero di telefono o carta di credito per iniziare; ogni nuovo account riceve $0.50 di credito di prova valido per 7 giorni.

Imposta la base URL su https://api.sunoapis.com/v1 nella configurazione del client. L'identificatore del modello che devi inviare in ogni richiesta è uncensored. Questo è un modello a pesi aperti ospitato sui nostri server GPU, ottimizzato per l'uso creativo e per adulti leciti senza i rifiuti tipici dei principali fornitori.

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

Prima Richiesta

Inizia immediatamente con una richiesta standard di completamento chat. L'endpoint accetta payload JSON contenenti il tuo prompt di sistema, le istruzioni utente e qualsiasi metadato necessario per la tua pipeline di testo-video o musica AI.

Questa è un'API solo testo. Non genera audio, video o immagini; genera le istruzioni testuali che guidano questi strumenti. Usa questo endpoint per scrivere scene, comporre testi o estrarre dati strutturati dalle tue risorse creative.

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."}]
  }'

SDK Python

Integra l'API nelle tue applicazioni Python utilizzando l'SDK ufficiale di OpenAI. Essendo compatibile con OpenAI, puoi riutilizzare il tuo codice esistente modificando semplicemente la base URL e la chiave API.

Questo approccio funziona per generare script per strumenti di generazione video o scrivere metadati per API musicali. Assicurati che la versione del tuo SDK sia aggiornata per supportare le funzionalità di streaming e chiamata di funzioni descritte nelle sezioni successive.

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)

SDK Node.js

Per gli sviluppatori JavaScript/TypeScript, il pacchetto @anthropic-ai/sdk o il pacchetto ufficiale openai funzionano con lievi modifiche alla configurazione. Indica al tuo client il nostro Base URL e usa l'ID del modello uncensored.

Questo ti permette di costruire la generazione di testo lato server per le tue app creative. Puoi usarlo per pre-elaborare gli input utente o post-elaborare gli script generati prima di inviarli ai tuoi endpoint di generazione audio o video. L'API restituisce risposte JSON standard compatibili con i framework web moderni.

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

Risposte in Streaming

Per script lunghi o metadati dettagliati, utilizza Server-Sent Events (SSE) per ricevere i token in tempo reale. Imposta stream: true nel corpo della richiesta. L'API invierà una serie di chunk, permettendoti di visualizzare il testo mentre viene generato.

Questo è particolarmente utile per strumenti creativi interattivi dove gli utenti vogliono vedere il prompt evolversi mentre viene scritto. Ogni chunk contiene solo il testo delta, quindi devi concatenare i frammenti per ricostruire la risposta completa.

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)

Limiti, Errori e Contesto

Ogni account è limitato a una sola chiave API, che può essere rigenerata in qualsiasi momento (revocando quella vecchia). Hai diritto a 300 richieste al minuto per chiave, con una dimensione massima del corpo della richiesta di 8 MB.

Gli errori comuni includono 401 per chiavi non valide, 402 se hai credito prepagato insufficiente e 429 per i limiti di richieste. Il modello supporta una finestra di contesto da 100.000 token per input e output combinati.

Nota sul contenuto: Il modello non rifiuta argomenti controversi o per adulti, ma blocca rigorosamente i contenuti sessuali che coinvolgono minori in tutte le richieste.