Documentazione API & Guida Rapida

Autenticazione & URL di Base

Inizia generando la tua chiave sulla dashboard. Utilizziamo intestazioni standard compatibili con OpenAI, quindi devi solo aggiornare il tuo base_url e API_KEY variabili. Questo garantisce che le tue integrazioni SDK esistenti funzionino senza modifiche. Supportiamo l'accesso con Google o la registrazione tramite email e password, e la tua chiave appare immediatamente alla creazione.

• Base URL: https://api.routeropen.cc/v1
• Intestazione Auth: Authorization: Bearer YOUR_API_KEY

Mantieni la chiave sicura, poiché controlla il tuo credito prepagato. Ogni account consente una chiave attiva alla volta; generarne una nuova sostituisce immediatamente quella vecchia.

Prima richiesta

Invia il tuo primo prompt utilizzando lo standard chat/completions endpoint. endpoint. L'ID del modello è semplicemente uncensored. Questo servizio invia testo in ingresso e restituisce testo in uscita, senza filtri di contenuto per l'uso adulto legale.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Questa richiesta dimostra la struttura di base. Puoi regolare parametri come temperature o top_p per controllare la creatività. La risposta include statistiche sull'utilizzo dei token per una fatturazione trasparente.

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per integrare la nostra API. Indirizza il client al nostro URL di base e utilizza la tua chiave API. Questo approccio funziona perfettamente con i codici esistenti che puntano già a OpenAI.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.routeropen.cc/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 libreria gestisce automaticamente la serializzazione JSON e lo streaming. Puoi configurare la logica di retry e i timeout secondo necessità. Il nostro endpoint supporta i parametri standard, rendendo la migrazione da altri provider molto semplice.

Integrazione SDK Node

Per gli sviluppatori JavaScript, l'SDK Node funziona con modifiche minime. Imposta il baseURL al nostro endpoint e fornisci la tua chiave. Questo ti permette di mantenere il tuo flusso di lavoro di sviluppo attuale mentre accedi ai modelli uncensored.

Copyimport OpenAI from "openai";

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

Gli utenti Node possono sfruttare i pattern async/await per un codice pulito. La struttura della risposta corrisponde agli standard OpenAI, garantendo la compatibilità con i parser esistenti. Puoi cambiare modello o provider modificando solo due variabili.

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. Restituiamo Server-Sent Events (SSE) per la consegna dei token in tempo reale. Questo 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)

L'ultimo chunk contiene l'utilizzo totale dei token per la fatturazione. Lo streaming funziona con tutti i parametri, incluso il function calling. Usalo per le interfacce chat dove il feedback istantaneo è critico. Gli errori vengono comunque restituiti come eventi SSE, quindi puoi gestire i fallimenti in modo elegante.

Limiti, Errori & Contesto

La nostra API impone una finestra di contesto di 100.000 token e un limite del corpo della richiesta di 8 MB. Puoi effettuare 300 richieste al minuto per chiave. Se superi questo limite, ricevi un errore di limite di rateo 429. I fallimenti di autenticazione restituiscono 401 e i crediti insufficienti restituiscono 402.

Gli errori non consumano il tuo credito prepagato. Se invii una richiesta malformata, non ti viene addebitato nulla. Il modello rifiuta le richieste che coinvolgono minori, ma altrimenti consente contenuti non restrittivi. Mantieni una gestione degli errori robusta per gestire efficacemente i limiti di frequenza.