Guida all'Integrazione per Sviluppatori

Impostazione dell'URL di base e autenticazione

Inizia generando la tua chiave sulla dashboard. L'URL base è HTTPS://api.apiaicheap.com/v1. Invia la tua chiave nell'intestazione Authorization come token bearer.

• Clicca "Ottieni chiave API" e accedi con Google o email.
• Copia la chiave immediatamente; viene mostrata solo una volta.

Questa chiave autentica tutte le richieste all'endpoint delle completazioni della chat.

Intestazione di esempio

Autorizzazione: Bearer YOUR_API_KEY

Prima richiesta con cURL

Invia una semplice completamento della chat per testare la tua configurazione. Usa l'endpoint POST /v1/chat/completions con il modello "uncensored".

Questo conferma il tuo saldo di crediti e la latenza.

• Imposta il ruolo su "user".
• Mantieni il messaggio semplice per il primo test.

Controlla la risposta per un campo di testo generato.

• Cerca il valore "content".

Se ottieni un 200 OK, la tua integrazione sta funzionando.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per un'integrazione semplice. Indirizzalo al nostro URL di base e imposta la tua chiave API.

Questo approccio gestisce automaticamente i tentativi e l'analisi JSON.

• Installa la libreria tramite pip.
• Imposta il parametro base_url sul nostro endpoint.

Chiama il metodo chat.completions.create.

Passa la tua lista di messaggi come argomento.

• Includi il nome del modello "uncensored".

Accedi al testo di risposta tramite gli attributi dell'oggetto.

Questo metodo è pulito e leggibile per gli script di produzione.

Copyfrom openai import OpenAI

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

Configurazione SDK Node.js

L'SDK Node.js funziona in modo simile alla versione Python. Inizializza il client con la tua chiave e il nostro URL di base.

Questo ti permette di utilizzare i pattern asincroni familiari await/await.

• Importa il pacchetto OpenAI.
• Configura l'URL di base nel costruttore.

Crea una richiesta di completamento con i tuoi messaggi.

Gestisci la promise per ottenere il risultato.

• Estrai il contenuto del messaggio dalla risposta.

Registra l'output per verificare che il modello risponda correttamente.

Questa configurazione è ideale per server web e servizi backend.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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 con SSE

Abilita lo streaming impostando stream su true nella tua richiesta. L'API restituisce i chunk man mano che vengono generati tramite Server-Sent Events.

Questo riduce la latenza percepita per gli utenti nelle app di chat.

• Imposta stream: true nel payload.
• Elabora ogni chunk man mano che arriva.

Combina i chunk per formare la risposta finale.

I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk.

• Verifica il campo "usage" nell'ultimo chunk.

Questo approccio mantiene l'interfaccia utente reattiva durante le generazioni lunghe.

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 finestra di contesto

Il tuo account ha un limite di 300 richieste al minuto per chiave. La finestra di contesto supporta 100.000 token totali per prompt e completamento.

Gli errori vengono gestiti con codici di stato HTTP standard.

• 401 indica una chiave API non valida o mancante.
• 402 significa che il tuo credito prepagato è esaurito.
• 429 segnala che hai superato il limite di velocità.

I rifiuti non costano credito. Anche gli errori sono gratuiti.

L'output max è 16.000 token per richiesta. Imposta max_tokens se ne hai bisogno di meno.

Questa struttura garantisce fatturazione e prestazioni prevedibili.