Documentazione API: Completamenti Chat

URL Base e Autenticazione

L'URL di base è https://api.routeria.cc/v1. Passa la tua chiave API nel Authorization header. Errori e rifiuti sono gratuiti, quindi paghi solo per i token generati.

• GET /v1/models elenca i modelli disponibili.
• POST /v1/chat/completions gestisce la generazione del testo.

L'autenticazione è rigorosa. Un errore 401 significa che la tua chiave non è valida o è mancante. Un errore 402 indica credito prepagato insufficiente. Puoi ricaricare con USDT (TRC20) o USDC (Base).

Prima richiesta con cURL

Invia una richiesta POST all'endpoint di completamento della chat. L'ID del modello è uncensored. È un modello open-weight ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale.

Devi impostare il Content-Type header per application/json. Il corpo della richiesta include l'ID del modello e la tua matrice di messaggi.

Gli errori non consumano il tuo credito. Puoi verificare la tua chiave chiamando prima l'endpoint dei modelli.

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

Integrazione SDK Python

Utilizza l'SDK Python ufficiale di OpenAI. Imposta l'URL di base su https://api.routeria.cc/v1 e fornisci la tua chiave API. L'ID del modello rimane uncensored.

Questo approccio mantiene intatto il codice esistente. Si modifica solo l'oggetto di configurazione. L'SDK gestisce automaticamente la serializzazione JSON e la logica di ritentativa.

Lo streaming è supportato tramite stream parametro. Ricevi chunk di testo man mano che vengono generati.

Copyfrom openai import OpenAI

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

Utilizzo SDK Node

Inizializza il client con l'URL base corretto. Passa l'ID del modello uncensored nelle tue chiamate di completamento.

L'SDK Node riflette l'implementazione Python. Puoi trasmettere le risposte o attendere il completamento completo. L'utilizzo dei token viene segnalato nell'ultimo chunk.

Assicurati che le tue variabili di ambiente memorizzino la chiave in modo sicuro. La chiave API viene mostrata immediatamente al momento della registrazione tramite Google o email.

Copyimport OpenAI from "openai";

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

Streaming e Utilizzo dei Token

Abilita lo streaming impostando stream: true nella tua richiesta. Ricevi Server-Sent Events (SSE) per ogni token.

L'ultimo chunk contiene le statistiche complete sull'utilizzo dei token. I token di input sono fatturati a $0.15 per 1M di token. I token di output costano $0.50 per 1M di token.

Lo streaming riduce la latenza percepita. Puoi visualizzare il testo man mano che arriva. La finestra di contesto supporta 100,000 token in totale.

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)

Function Calling e modalità JSON

Abilita il richiamo di funzioni con il tools parametro. Il modello supporta tool_choice per un controllo rigoroso. Usa response_format: {"type": "json_object"} per output strutturato.

Questo garantisce un parsing coerente nella tua applicazione. Il modello è ottimizzato per risposte chiare e strutturate.

Puoi combinare gli strumenti con lo streaming. Il modello invocherà le funzioni quando necessario. Tutti i parametri come temperature e top_p sono supportati.

Parametri: Temperatura, Top-P, Stop

Regola temperature per la creatività. Valori più bassi rendono gli output più deterministici. top_p controlla il campionamento del nucleo (nucleus sampling). Imposta stop sequenze per interrompere la generazione.

Altri parametri supportati includono seed, presence_penalty, e frequency_penalty. Questi permettono di affinare lo stile di output.

Il massimo di output predefinito è di 2.048 token. Puoi aumentarlo fino a 16.000 token per richiesta. La finestra di contesto totale è di 100.000 token.

Limiti e Quote

Ogni chiave API è limitata a 300 richieste al minuto. Puoi avere 8 richieste concorrenti per chiave. La dimensione del corpo della richiesta è limitata a 8 MB.

Un errore 429 indica che hai superato il limite di velocità. Attendi prima di riprovare. Ogni account ha una chiave attiva; una nuova chiave sostituisce quella vecchia.

L'ID del modello è sempre uncensored. Non è GPT, Claude o alcun altro modello di vendor. È un modello open-weight eseguito sui nostri server.