Prompt e script su un singolo endpoint
Ottieni la tua chiave API testuale senza censura e inizia a inviare richieste alla pipeline testuale di stableaudio in pochi minuti. Usa l'endpoint compatibile con OpenAI per l'ingegneria dei prompt, la sottotitolazione o il post-processing con fatturazione prepagata prevedibile.
URL di base e autenticazione
Usa l'URL di base https://api.stableaudio.top/v1 con qualsiasi client compatibile con OpenAI. Passa la tua chiave API nell'intestazione Authorization come Bearer YOUR_API_KEY. Puoi generare una chiave istantaneamente nella pagina Ottieni chiave API usando Google o email + password. Ogni account supporta una chiave attiva; l'emissione di una nuova chiave sostituisce quella precedente. L'endpoint supporta solo POST /v1/chat/completions e GET /v1/models. Non sono disponibili embeddings, generazione di immagini, audio o video. Questo è un layer solo testo per la tua pipeline audio.
Invia la tua prima richiesta
Invia una richiesta standard di completamento chat per generare testo. L'ID del modello è uncensored. È un modello a pesi aperti ottimizzato per ridurre i rifiuti di contenuto su argomenti adulti leciti. Puoi regolare parametri come temperature e top_p. Il modello ha una finestra di contesto da 100.000 token. Puoi richiedere fino a 32.000 token per risposta. I prezzi sono trasparenti: $0,15 per 1M di token in input e $0,50 per 1M di token in output. Errori e rifiuti non consumano credito.
curl https://api.stableaudio.top/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."}]
}'
Integrazione SDK Python
Usa l'SDK Python ufficiale di OpenAI per integrare l'API nei tuoi script Python. Imposta base_url e api_key nella configurazione del tuo client. Questo ti permette di sfruttare codebase esistenti che usano già l'interfaccia di OpenAI. Il client gestisce automaticamente la serializzazione JSON e l'analisi delle risposte. Puoi eseguire lo streaming delle risposte o elaborarle in modalità batch. Questo approccio funziona per la generazione di prompt, la scrittura di script o l'estrazione di dati strutturati da input di testo per il tuo flusso di lavoro audio.
from openai import OpenAI
client = OpenAI(base_url="https://api.stableaudio.top/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)
Integrazione SDK Node.js
Integra l'API nelle tue applicazioni Node.js usando l'SDK Node di OpenAI. Configura il client con l'URL di base e la chiave API corretti. Questo garantisce la compatibilità con gli standard pattern di OpenAI. Puoi effettuare richieste sincrone o asincrone. Usalo per l'elaborazione testuale in tempo reale negli webhook o nei lavori in background. L'SDK gestisce la logica di retry e l'analisi delle risposte. È ideale per creare script di voice-over o pipeline di sottotitolazione che richiedono output testuale affidabile e senza censura senza costi di abbonamento.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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 (SSE)
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE). Le informazioni sull'utilizzo dei token sono incluse nel blocco finale. Questo riduce la latenza percepita per la generazione di testi lunghi. Usalo per la sottotitolazione in diretta o il perfezionamento interattivo dei prompt. L'ID del modello rimane uncensored. Lo streaming non cambia il modello di pricing. Paghi solo per i token effettivi generati. Gli errori durante lo streaming sono gestiti in modo elegante senza consumare credito extra.
stream = 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 e quote sui token
Il modello supporta una finestra di contesto da 100.000 token. Il massimo in output è 32.000 token per richiesta, o 2.048 se max_tokens non è impostato. Sei limitato a 300 richieste al minuto per chiave. La concorrenza è limitata a 8 richieste simultanee per chiave. I corpi delle richieste non devono superare 8 MB. Se superi il limite di richieste, ricevi un errore 429. Se la tua chiave non è valida, ricevi un errore 401. Se non hai credito prepagato sufficiente, ricevi un errore 402. Errori e rifiuti sono gratuiti. Il credito non scade mai. Ricarica con carta (Visa, Mastercard, Apple Pay, Google Pay) o cripto (USDT su TRC20, USDC su Base) da $20 a $500.
Scheda tecnica dell'API
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| ID modello | uncensored |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.stableaudio.top/v1 |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Modalità JSON | response_format: {"type": "json_object"} |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Finestra di contesto | 100.000 token (input + output) |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Dimensione | fino a 8 MB per richiesta |
| Concorrenza | 8 richieste contemporanee per chiave |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Prezzo | $0,15 per 1M token in input · $0,50 per 1M in output |
| Bonus | +5% da $50, +10% da $100, +15% da $200 |
| Prova gratuita | $0,50 per 7 giorni, senza carta · Chiave di prova: 2 richieste parallele, 60 al minuto; limiti completi (8 e 300) dopo la prima ricarica |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $20 a $500 |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
| Accesso | Google oppure e-mail e password |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| Codice | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |
Domande e risposte
Cosa significa 'uncensored' per questa API?
Il modello non rifiuta argomenti legali per adulti, di finzione, di ricerca sulla sicurezza o controversi. È ottimizzato per rispondere senza rifiuti di contenuti. L'unico limite rigido è che i contenuti sessuali che coinvolgono minori sono sempre bloccati.
Come funziona la fatturazione e quando gli errori sono gratuiti?
Paga solo per l'utilizzo reale di token. Errori e rifiuti non consumano il tuo credito prepagato. Il credito viene ricaricato con carta (Visa, Mastercard, Apple Pay, Google Pay) o cripto (USDT su TRC20, USDC su Base) e non scade mai. Puoi ricaricare da $20 a $500.
Posso usarlo per la generazione di immagini o audio?
No. Questa è un'API chat-completions solo testo. Fornisce il livello testuale per la tua pipeline audio, ad esempio per la scrittura di prompt o la sottotitolazione. Non genera immagini, audio o video direttamente.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.