Dolphin sans censure API Documentation

Prérequis et configuration de l'environnement

Commencez par vous assurer que votre environnement dispose des dépendances nécessaires installées avant d'envoyer des requêtes. Vous aurez besoin d'une clé API active depuis notre tableau de bord et d'un environnement d'exécution pris en charge comme Python ou Node.js. Notre API vous demande d'envoyer des requêtes à une URL de base spécifique plutôt que au point de terminaison OpenAI par défaut.

Conservez votre clé API en sécurité et stockez-la dans une variable d'environnement. Cela évite une exposition accidentelle dans votre dépôt de code. Vous pouvez générer une nouvelle clé instantanément après vous être inscrit avec Google ou par e-mail.

Vous n'avez pas besoin de configurer un routage complexe ou de sélectionner des modèles spécifiques. Le point de terminaison sert un seul modèle de langage large sans censure conçu pour la sortie de texte directe.

Installation du SDK OpenAI officiel

Installez le package SDK officiel afin de gérer automatiquement l'authentification et le formatage des requêtes. Cette bibliothèque prend en charge les environnements Python et Node.js avec des interfaces cohérentes.

Pour les utilisateurs Python, exécutez la commande standard pip install pour ajouter la bibliothèque à votre environnement virtuel. Les développeurs Node.js doivent utiliser npm pour installer le package équivalent.

Le SDK gère la structure du payload JSON pour vous, vous n'avez donc besoin de vous concentrer que sur le contenu du prompt et des paramètres tels que la température ou le top_p.

Vous pouvez vérifier l'installation en important la bibliothèque dans votre script ou module. Cela garantit que le client est prêt à se connecter à nos serveurs.

Configuration de l'URL de base et de la clé API

Pointez votre client SDK vers notre URL de base spécifique pour acheminer les requêtes vers notre infrastructure sans censure. Utilisez https://api.dolphinuncensored.com/v1 comme votre point de terminaison.

Définissez votre clé API dans l'en-tête d'autorisation ou l'objet de configuration du client. Le client attachera automatiquement cette clé à chaque requête.

Assurez-vous de spécifier l'ID de modèle comme "uncensored" dans votre configuration. Cela indique au serveur quelle version du modèle utiliser pour votre génération.

Effectuer votre première complétion de chat

Envoyez un simple message pour vérifier la connectivité et recevoir une réponse. Cela confirme que votre clé est valide et que le point de terminaison est accessible.

Utilisez le point de terminaison chat-completions avec une invite système et un message utilisateur. La réponse contiendra le texte généré dans le champ content.

Comprendre le streaming et l'utilisation des jetons

Activez le streaming pour recevoir les jetons au fur et à mesure de leur génération plutôt que d'attendre la réponse complète. Cela améliore la latence perçue pour les sorties longues.

L'API renvoie les statistiques d'utilisation dans le dernier fragment du flux. Vous pouvez suivre les comptes de jetons d'entrée et de sortie pour une transparence de facturation.

Définissez le paramètre stream sur true dans le corps de votre requête. Itérez à travers les chunks pour construire votre texte final ou traitez-le en temps réel.

Gestion des erreurs et des refus

Gérez les erreurs HTTP 401 en vérifiant que votre clé API est correcte et non expirée. Une erreur 402 indique un crédit prépayé insuffisant ; rechargez via la crypto pour continuer.

Un statut 429 signifie que vous avez atteint la limite de taux de 300 requêtes par minute. Attendez brièvement avant de réessayer ou réduisez votre concurrence.

Le modèle refuse les demandes impliquant du contenu sexuel avec des mineurs, ce qui constitue une limite stricte. Les autres sujets controversés ou adultes sont généralement autorisés. Les erreurs et les refus ne consomment pas votre crédit de tokens.

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)