Guida rapida API OpenRouter dolphin
Inizia con la nostra API LLM senza censure in pochi minuti. Utilizza SDK OpenAI standard per inviare richieste al nostro endpoint dedicato.
URL Base e Autenticazione
L'URL di base per tutte le richieste è https://api.openrouterdolphin.com/v1. Autenticati passando la tua chiave API in Authorization
curl https://api.openrouterdolphin.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
}'L'autenticazione è rigorosa. Non supportiamo più chiavi per account. Generare una nuova chiave invalida immediatamente quella precedente. Questo garantisce un tracciamento pulito del tuo utilizzo per i crediti prepagati.
Endpoint: POST /v1/chat/completions
Invia dati di testo per generare risposte utilizzando il uncensored model. Questo endpoint gestisce tutti i completamenti di chat standard. Definisce il modello, i messaggi e i parametri nel corpo della richiesta.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterdolphin.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)L'API restituisce un oggetto JSON standard contenente il testo generato. Non supporta embedding, immagini o audio. Concentrati sui flussi di lavoro di generazione del testo. Il modello risponde ai prompt senza filtrare argomenti adulti legali o controversi.
Endpoint: GET /v1/models
Recupera i modelli disponibili tramite una semplice richiesta GET. Questo endpoint conferma l'ID del modello che devi utilizzare.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterdolphin.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);La risposta elenca il uncensored model. Usa esattamente questo ID nelle tue richieste di completamento. L'API serve solo questo singolo modello. Non c'è logica di routing o selezione del modello. Interagisci direttamente con la nostra istanza LLM uncensored dedicata.
Streaming e dati di utilizzo
Abilita lo streaming impostando stream: true. L'API restituisce chunk tramite Server-Sent Events (SSE). Ogni chunk contiene una parte del testo di 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. Paghi strettamente per i token di output generati. Errori e rifiuti non comportano costi. Questa struttura permette il rendering in tempo reale delle risposte nelle tue applicazioni.
Parametri: Temperatura, Top P e Strumenti
Controlla il comportamento di generazione con parametri standard. Imposta temperature per la casualità e top_p per il campionamento nucleare. Abilita il richiamo di funzioni fornendo un tools array.
Usa response_format con {"type": "json_object"} per l'output JSON rigoroso. Puoi anche impostare seed per la riproducibilità. L'API supporta presence_penalty e frequency_penalty per l'affinamento dell'uso delle parole. Questi parametri funzionano esattamente come nei client OpenAI standard.
Limiti di frequenza e dimensione della richiesta
Ogni chiave API consente 300 richieste al minuto. Puoi effettuare fino a 8 richieste concorrenti in qualsiasi momento. La dimensione massima del corpo della richiesta è di 8 MB. La finestra di contesto supporta 100.000 token per input e output combinati.
L'output massimo per richiesta è di 16.000 token. Se non imposti max_tokens, il valore predefinito è 2.048 token. Superare questi limiti restituisce un errore 429. Pianifica di conseguenza la tua strategia di batch. I crediti non scadono mai, quindi puoi accumulare l'utilizzo nel tempo senza pressioni.
Domande frequenti
Come ottengo una chiave API per openrouter dolphin?
Iscriviti utilizzando Google o un indirizzo email nella pagina Ottieni chiave API. La tua chiave appare immediatamente. Non è richiesto il numero di telefono. Puoi generare una nuova chiave in qualsiasi momento, che sostituisce istantaneamente quella vecchia.
Cosa succede se vengo limitato dalla frequenza?
Ricevi un errore 429 quando superi le 300 richieste al minuto o le 8 richieste concorrenti. Attendi brevemente e riprova. Considera di raggruppare le tue richieste o di ridurre la concorrenza. I limiti sono per chiave API, quindi l'utilizzo di più chiavi (creando più account) può aumentare il throughput.
Il modello senza filtri filtra i contenuti?
Il modello non rifiuta argomenti legali per adulti, di fantasia o controversi. L'unico limite rigido riguarda i contenuti sessuali che coinvolgono minori. Le richieste contenenti quel tipo specifico di contenuto vengono rifiutate. Tutto il resto passa senza i tipici rifiuti dell'IA.
Ottieni la tua chiave API ora
Registrati, copia la tua chiave e aggiorna l'URL di base. È tutto ciò che devi fare.
