API Stable Diffusion: Prompt e script su un unico endpoint

Accedi all'API utilizzando l'URL base https://api.sdxlapi.com/v1. Questo endpoint è pienamente compatibile con gli SDK e i client standard OpenAI. Per l'autenticazione, passa la tua chiave API nell'intestazione Authorization di ogni richiesta.

Come ottenere una chiave: Registrati alla pagina Ottieni chiave API inserendo solo email e password. La tua chiave viene visualizzata immediatamente. Non è richiesta una carta di credito per la prova. Mantieni la chiave al sicuro; puoi rigenerarla in qualsiasi momento, il che rende invalida quella precedente.

Invia una richiesta standard chat-completions per generare testo. L'ID del modello è uncensored. Questo modello è ottimizzato per rispondere senza rifiuti di contenuti per uso adulto lecito, rendendolo ideale per la generazione creativa di prompt.

Copycurl https://api.sdxlapi.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."}]
  }'

L'API accetta payload JSON con un array messages. Restituisce un completamento di testo. Puoi passare prompt di sistema per definire la persona, ad esempio un ingegnere di prompt professionista per la generazione di immagini.

Utilizza il pacchetto Python ufficiale openai. Configura il client con l'URL base e la tua chiave API. Questo approccio funziona per qualsiasi client compatibile con OpenAI.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sdxlapi.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)

La risposta contiene il testo generato in response.choices[0].message.content. Puoi analizzare direttamente questo output nella tua pipeline per la generazione di didascalie o l'estrazione di metadati. L'SDK gestisce automaticamente la serializzazione JSON e i dettagli HTTP.

Per progetti JavaScript o TypeScript, usa il pacchetto npm openai. Imposta baseURL e apiKey nell'oggetto di configurazione. Questo garantisce la compatibilità con i repository OpenAI esistenti.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sdxlapi.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);

La struttura della risposta rispecchia il formato standard OpenAI. Accedi al testo generato tramite response.data.choices[0].message.content. Questo è utile per la generazione di prompt lato server prima di inviare immagini a un'istanza Stable Diffusion.

Il supporto per gli eventi inviati dal server (SSE) ti consente di ricevere i token man mano che vengono generati. Questo riduce la latenza percepita per script di prompt lunghi o descrizioni dettagliate.

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)

Esegui lo streaming della risposta nella tua applicazione client. Ogni frammento contiene un messaggio parziale. Aggrega questi frammenti per ricostruire il testo finale. Questo è particolarmente utile per l'anteprima in tempo reale dei prompt generati in un'interfaccia web.

Limiti di Richiesta: 300 richieste al minuto per chiave. Dimensione del Corpo: Max 8 MB. Finestra di Contesto: 100.000 token totali (input + output). Questo permette script lunghi o ingegneria dei prompt estesa.

Errori Comuni:

• 401 Unauthorized: Chiave API non valida o mancante.
• 402 Payment Required: Credito prepagato insufficiente.
• 429 Too Many Requests: Limite di richieste superato.

Se superi i limiti, attendi brevemente o rigenera la tua chiave. Tutte le richieste sono solo testo; non vengono generate immagini, audio o video da questa API.