Chiavi OpenRouter ai: guida rapida

URL Base & Autenticazione

La tua chiave API autentica ogni richiesta al nostro endpoint. Usa l'URL base https://api.openrouteraikeys.com/v1 e passa la tua chiave nell' Authorization header. Questa configurazione funziona con qualsiasi SDK compatibile con OpenAI perché rispecchiamo il loro pattern di autenticazione standard. Non devi modificare la tua libreria client, solo la configurazione dell'URL di base.

• Intestazione: Authorization: Bearer YOUR_API_KEY
• Base URL: https://api.openrouteraikeys.com/v1

Prima richiesta

Invia una richiesta standard di completamento chat per testare la connettività e il formato della risposta. L'ID del modello è uncensored e accetta array di messaggi standard. Questo endpoint restituisce solo testo, quindi non aspettarti dati immagine o audio nel payload della risposta.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Integrazione SDK Python

Inizializza il client con la tua chiave e l'URL base personalizzato. Questo ti permette di utilizzare la familiare chat.completions.create metodo senza avvolgere logica aggiuntiva. La libreria gestisce la serializzazione e la logica di retry automaticamente per te.

Copyfrom openai import OpenAI

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

Integrazione SDK Node

Configura il OPENAI_API_KEY e OPENAI_BASE_URL variabili d'ambiente o passale direttamente al costruttore del client. Questo garantisce che tutte le chiamate successive vengano instradate attraverso il nostro endpoint uncensored. Puoi continuare a utilizzare la stessa versione dell'SDK che hai già installato.

Copyimport OpenAI from "openai";

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

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce chunk Server-Sent Events (SSE) man mano che il modello genera testo. Le statistiche di utilizzo dei token appaiono nell'ultimo chunk dello stream, consentendoti di monitorare i costi in tempo reale senza attendere l'intera risposta.

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 & Contesto

La finestra di contesto supporta un totale di 100.000 token per prompt e completamento. Sei limitato a 300 richieste al minuto per chiave. Un errore 401 indica che la tua API key non è valida o è mancante. Un errore 402 segnala credito prepagato insufficiente. Un errore 429 indica che hai superato il limite di frequenza. I rifiuti dovuti alla policy sui contenuti sono gratuiti, ma gli errori di calcolo possono consumare token.