Documentazione API

URL Base e Autenticazione

L'endpoint dell'API si trova presso https://api.openrouteraiapi.com/v1. Passa la tua chiave API nel Authorization header come token bearer. Questo header è l'unica modifica necessaria per reindirizzare il traffico dal tuo provider attuale al nostro modello uncensored.

L'autenticazione è rigorosa. Se la chiave è mancante o non valida, il server restituisce immediatamente un errore 401. Puoi generare una chiave istantaneamente tramite Google o email sul dashboard. Mantieni la chiave sicura, poiché garantisce l'accesso al tuo credito prepagato.

Endpoint Chat Completions

Invia richieste POST a /v1/chat/completions con un array di messaggi. L'identificatore del modello è uncensored. Questo modello singolo gestisce tutte le tue esigenze di generazione di testo senza logica di routing complessa.

Ecco una richiesta standard in cURL per verificare la connettività e il formato della risposta.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

La risposta include il testo generato in choices[0].message.content campo. Puoi analizzarlo direttamente nel flusso di lavoro della tua applicazione.

Integrazione SDK Python

Utilizza il client Python ufficiale di OpenAI per connetterti senza sforzo. Imposta base_url e api_key variabili per puntare alla nostra infrastruttura. Questo approccio minimizza le modifiche al codice quando si cambiano i provider.

Copyfrom openai import OpenAI

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

Il client gestisce la serializzazione e i tentativi automaticamente. Ricevi un oggetto di completamento contenente il testo e le statistiche di utilizzo dei token. Questo metodo è ideale per servizi backend e script.

Utilizzo SDK Node.js

Inizializza il client Node.js OpenAI con il tuo URL di base personalizzato. Questo permette alle applicazioni JavaScript di interagire con il modello uncensored utilizzando metodi familiari. Il SDK gestisce le richieste HTTP in modo efficiente.

Copyimport OpenAI from "openai";

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

Chiama chat.completions.create() con i tuoi messaggi. L'oggetto di risposta fornisce l'accesso al contenuto generato e ai dati di utilizzo. Questa integrazione funziona bene per server web e funzioni edge.

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. Il server restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Questa funzione riduce la latenza percepita per gli utenti finali.

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)

Ogni chunk contiene contenuto parziale. L'ultimo chunk include le statistiche complete sull'utilizzo dei token. Gestisci questi eventi nel tuo client per aggiornare l'UI in modo incrementale.

Limiti, Errori e Finestra di Contesto

La finestra di contesto supporta 100.000 token per input e output combinati. Ogni richiesta può generare fino a 16.000 token, o 2.048 se max_tokens è non impostato. I limiti di frequenza consentono 300 richieste al minuto per chiave.

Gli errori sono codici HTTP standard. Un 401 indica una chiave non valida. Un 402 significa che il tuo credito prepagato è esaurito. Un 429 segnala che hai superato il limite di frequenza. Le richieste che falliscono non consumano credito. Gli errori sono gratuiti.