it ▾
Ottieni la tua chiave

Integra routerapi in Minuti

Inserisci il tuo codice compatibile con OpenAI esistente in routerapi con una singola modifica alla variabile. Ottieni un endpoint senza filtri attivo in pochi minuti senza dover ricalibrare la logica di integrazione.

Contenuti

Impostazione dell'URL di Base e Autenticazione

Modifica base_url e api_key per cambiare provider istantaneamente. Punta il tuo SDK a HTTPS://api.routerapi.cc/v1 e usa la chiave generata dal tuo dashboard. Non sono necessarie regole di routing complesse o configurazioni multi-modello. Le tue intestazioni e la configurazione del client esistenti rimangono identiche allo standard OpenAI.

La chiave viene visualizzata immediatamente dopo la registrazione tramite Google o email. Conservala in modo sicuro e passala come Bearer token nell'intestazione HTTP Authorization. Questa singola modifica instrada tutte le richieste al nostro modello uncensored senza alterare il codice della tua applicazione.

Invio di una richiesta di completamento chat

Invia un standard POST richiesta a /v1/chat/completions per generare testo. L'endpoint accetta la stessa struttura JSON utilizzata da OpenAI, garantendo che i tuoi prompt funzionino senza modifiche. Utilizza l'ID del modello uncensored al nostro modello linguistico di grandi dimensioni ottimizzato per risposte senza restrizioni.

Ogni richiesta consuma token dal tuo saldo prepagato. Errori e rifiuti non addebitano il tuo credito, così puoi testare liberamente. L'esempio seguente dimostra una chiamata di generazione di testo di base utilizzando l'SDK ufficiale.

curl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

La risposta restituisce il testo generato nel choices[0].message.content campo. Puoi regolare parametri come temperature o top_p per controllare la creatività. Non sono disponibili endpoint per embedding o generazione di immagini; questo servizio si concentra strettamente sul completamento del testo.

Gestione delle risposte in streaming (SSE)

Abilita lo streaming impostando stream: true nel corpo della richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Questo riduce la latenza percepita per le interfacce chat e le applicazioni di roleplay. Ogni chunk contiene un delta parziale della risposta.

stream = 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 include le statistiche complete sull'utilizzo dei token per la richiesta. Analizza il content field da ogni delta per ricostruire il messaggio completo. Questo approccio mantiene la tua UI reattiva mentre il modello elabora contesti lunghi. I conteggi dei token nell'ultimo chunk riflettono sia l'utilizzo di input che di output.

Utilizzando Tools e Function Calling

Passa le definizioni degli strumenti in tools parametro per abilitare la chiamata delle funzioni. Il modello restituisce chiamate agli strumenti strutturate nella risposta invece che testo normale. Specifica tool_choice per forzare l'utilizzo di una funzione specifica o la selezione automatica. Questa funzionalità funziona in modo identico al formato di chiamata di funzioni di OpenAI.

from openai import OpenAI

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

Definisci le tue funzioni con schemi JSON e passale nella richiesta. L'API gestisce il routing tra la generazione di testo e l'invocazione degli strumenti. Usa il response_format con parametro {"type": "json_object"} per l'output JSON rigoroso quando non sono richiesti strumenti. Questo garantisce dati strutturati coerenti per i tuoi servizi backend.

Impostazione della modalità JSON per l'output strutturato

Forza il modello a restituire JSON validi impostando response_format a {"type": "json_object"}. Questo è essenziale per analizzare i dati nei flussi di lavoro automatizzati o negli agenti AI. Il modello cercherà di chiudere tutte le parentesi e di seguire lo schema richiesto. Possono verificarsi errori se l'output diventa troppo lungo per la finestra di contesto.

import OpenAI from "openai";

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

Combina la modalità JSON con temperature impostato a 0 per la massima determinismo. Usa questo valore per estrarre entità, formattare dati o generare file di configurazione. Il modello uncensored gestisce bene le strutture annidate complesse. Convalida sempre l'output nel tuo codice prima di elaborarlo.

Comprendere i limiti dei token e i costi

La finestra di contesto supporta 100.000 token per prompt e completamento combinati. Ogni richiesta può restituire fino a 16.000 token, o 2.048 se max_tokens è non impostato. Il prezzo è $0.15 per milione di token di input e $0.50 per milione di token di output. Il credito non scade e gli errori sono gratuiti.

Monitora il tuo utilizzo tramite la dashboard o le intestazioni di risposta. Le richieste sono limitate a 8 MB nella dimensione del corpo. Puoi ricaricare con USDT (TRC20) o USDC (Base) a partire da $20. Il credito bonus aumenta con depositi più grandi: +5% a $50, +10% a $100 e +15% a $200. Non sono applicati canoni di abbonamento.

Domande frequenti

Come gestisco i limiti di frequenza e gli errori?

L'API impone un limite di 300 richieste al minuto e 8 richieste concorrenti per chiave. Un codice di stato 429 indica che hai superato questi limiti; attendi brevemente prima di riprovare. Un errore 401 significa che la tua chiave API non è valida e un errore 402 indica credito prepagato insufficiente. Controlla il corpo del messaggio di errore per i dettagli su quale limite è stato attivato.

RouterAPI è adatto per l'uso in produzione ad alto volume?

Sì, il servizio supporta richieste concorrenti e streaming per applicazioni a bassa latenza. Tuttavia, non offre garanzie SLA e funzionalità avanzate come gli embedding. Utilizzalo per chat, roleplay o scrittura creativa dove l'output senza filtri è fondamentale. Monitora l'utilizzo dei token per assicurarti che il tuo saldo prepagato copra il tuo volume.

Cosa succede al mio credito se commetto un errore?

Il credito è prepagato e non scade mai, quindi i fondi non utilizzati rimangono disponibili indefinitamente. Gli errori come gli addebiti doppi vengono risolti tramite la pagina Assistenza. Errori e rifiuti non consumano il tuo credito, quindi testare i tuoi prompt è gratuito. Puoi ricaricare di nuovo in qualsiasi momento utilizzando criptovalute.

Ottieni la tua chiave API

Iscriviti, ottieni la tua chiave, punta al nuovo URL di base. Fatto.