Dolphin senza filtri API Documentazione

Prerequisiti e configurazione dell'ambiente

Inizia assicurando che il tuo ambiente abbia le dipendenze necessarie installate prima di effettuare qualsiasi richiesta. Avrai bisogno di una chiave API attiva dal nostro dashboard e di un runtime supportato come Python o Node.js. La nostra API richiede di inviare richieste a un URL base specifico invece che all'endpoint predefinito di OpenAI.

Mantieni la tua chiave API al sicuro e memorizzala in una variabile d'ambiente. Questo previene l'esposizione accidentale nel tuo repository di codice. Puoi generare una nuova chiave istantaneamente dopo la registrazione con Google o email.

Non hai bisogno di configurare routing complessi o selezionare modelli specifici. L'endpoint serve un unico modello di linguaggio grande uncensored progettato per l'output di testo diretto.

Installazione dell'SDK Ufficiale OpenAI

Installa il pacchetto SDK ufficiale per gestire autenticazione e formattazione delle richieste in modo automatico. Questa libreria supporta sia ambienti Python che Node.js con interfacce coerenti.

Per gli utenti Python, esegui il comando standard pip install per aggiungere la libreria al tuo ambiente virtuale. Gli sviluppatori Node.js dovrebbero usare npm per installare il pacchetto equivalente.

L'SDK gestisce per te la struttura del payload JSON, quindi devi concentrarti solo sul contenuto del prompt e su parametri come la temperatura o il top_p.

Puoi verificare l'installazione importando la libreria nel tuo script o modulo. Questo garantisce che il client sia pronto per connettersi ai nostri server.

Configurazione dell'URL Base e della Chiave API

Indirizza il client SDK al nostro URL di base specifico per instradare le richieste verso la nostra infrastruttura senza filtri. Usa https://api.dolphinuncensored.com/v1 come tuo endpoint.

Imposta la tua chiave API nell'intestazione di autorizzazione o nell'oggetto di configurazione del client. Il client allexerà questa chiave a ogni richiesta automaticamente.

Assicurati di specificare l'ID modello come "uncensored" nella tua configurazione. Questo dice al server quale versione del modello utilizzare per la tua generazione.

Esecuzione della tua prima chat completion

Invia un semplice messaggio per verificare la connettività e ricevere una risposta. Questo conferma che la tua chiave è valida e che l'endpoint è raggiungibile.

Usa l'endpoint chat-completions con un prompt di sistema e un messaggio utente. La risposta conterrà il testo generato nel campo content.

Comprendere lo streaming e l'utilizzo dei token

Abilita lo streaming per ricevere i token man mano che vengono generati invece di attendere la risposta completa. Questo migliora la latenza percepita per gli output lunghi.

L'API restituisce le statistiche di utilizzo nell'ultimo chunk dello stream. Puoi monitorare i conteggi dei token di input e output per una fatturazione trasparente.

Imposta il parametro stream su true nel corpo della richiesta. Itera attraverso i chunk per costruire il testo finale o elaboralo in tempo reale.

Gestione degli errori e dei rifiuti

Gestisci gli errori HTTP 401 verificando che la tua chiave API sia corretta e non scaduta. Un errore 402 indica un credito prepagato insufficiente; ricarica tramite cripto per continuare.

Un codice di stato 429 indica che hai raggiunto il limite di velocità di 300 richieste al minuto. Attendi brevemente prima di riprovare o riduci la concorrenza.

Il modello rifiuta le richieste che coinvolgono contenuti sessuali con minori, che è un limite rigido. Altri argomenti controversi o per adulti sono generalmente consentiti. Errori e rifiuti non consumano il tuo credito di token.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)