Dolphin AI API Démarrage rapide

URL de base & Authentification

Commencez par définir l'URL de base et la clé API dans la configuration de votre client. Toutes les requêtes s'authentifient via le Authorization header en utilisant votre clé unique. Notre service agit en tant que fournisseur indépendant pour le OpenRouter Dolphin AI le modèle variant, ce qui signifie que vous n'avez pas besoin d'un compte sur OpenRouter pour utiliser ce point de terminaison. Il vous suffit de récupérer votre clé depuis le tableau de bord et de la placer dans vos variables d'environnement.

• URL de base : https://api.openrouterdolphinai.com/v1
• En-tête : Authorization: Bearer YOUR_API_KEY

Cette configuration fonctionne avec n'importe quel SDK OpenAI standard car nous imitons leur structure exacte des points de terminaison. Vous n'interagirez qu'avec le point de terminaison des complétions de chat, gardant votre intégration simple et concentrée sur la génération de texte.

Première demande

Envoyez votre premier message pour générer du texte en utilisant le simple POST méthode. L'ID du modèle est toujours uncensored, ce qui garantit que vous obtenez la variante uncensored spécifique ajustée pour un dialogue sans restrictions. Vous n'avez pas besoin de spécifier des paramètres de routage complexes car nous hébergeons ce modèle unique directement.

Utilisez la commande curl suivante pour tester votre connexion immédiatement :

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Si vous recevez une réponse JSON avec du contenu, votre clé est active et les crédits sont déduits correctement. Les erreurs comme 401 indiquent une clé invalide, tandis que 402 signifie que vous devez recharger via crypto. Cette approche directe évite la variabilité des routeurs multi-modèles.

Intégration du SDK Python

Intégrez rapidement à l'aide de la bibliothèque Python OpenAI officielle en la pointant vers notre URL de base. Cela vous permet d'utiliser des méthodes familières comme chat.completions.create() sans réécrire toute votre logique. La bibliothèque gère la sérialisation automatiquement, vous pouvez ainsi vous concentrer sur la conception des prompts plutôt que sur les détails HTTP.

Configurez le client avec votre URL de base et votre clé :

Copyfrom openai import OpenAI

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

N'oubliez pas que notre fenêtre de contexte est de 100,000 tokens, vous pouvez donc transmettre un historique de conversation substantiel. Le SDK gérera le tokenisation et la transmission efficacement, garantissant que vos prompts atteignent le modèle sans surcharge ni erreurs de formatage inutiles.

Utilisation du SDK Node

Les développeurs Node peuvent obtenir les mêmes résultats en utilisant le openai paquet npm. Comme la version Python, vous devez remplacer l'URL de base par défaut pour pointer vers nos serveurs dédiés. Cela garantit que vos requêtes vont directement vers le modèle sans censure sans toucher aux limites de taux tierces ou aux délais de routage.

Initialiser le client avec le point de terminaison correct :

Copyimport OpenAI from "openai";

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

Ce modèle fonctionne à la fois pour les appels synchrones et les modèles async/await. Vous pouvez diffuser des réponses ou demander le mode JSON directement dans le même appel de fonction, ce qui vous offre une flexibilité pour différentes architectures d'application sans modifier votre configuration d'authentification principale.

Réponses en streaming

Activer la génération de texte en temps réel en définissant stream: true dans les paramètres de votre requête. L'API renvoie un flux Server-Sent Events (SSE), vous permettant d'afficher les jetons au fur et à mesure de leur génération. Cela réduit la latence perçue pour les utilisateurs, rendant l'expérience beaucoup plus rapide que d'attendre une réponse complète.

Gérez les chunks du flux pour accumuler le texte final :

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)

Chaque chunk inclut des données d'utilisation des tokens dans la dernière pièce, vous permettant de suivre les coûts avec précision. Le streaming est idéal pour les interfaces de chat où une réactivité immédiate améliore l'engagement des utilisateurs. Vous pouvez arrêter le flux à tout moment si l'utilisateur envoie un nouveau message, économisant ainsi des crédits sur les réponses partielles.

Limites, Erreurs & Contexte

Comprendre les limites techniques pour éviter les interruptions inattendues dans votre application. Notre API applique une fenêtre de contexte de 100 000 tokens pour chaque requête, combinant à la fois le prompt et la complétion. Si vous dépassez la limite de sortie de 16 000 tokens, la génération s'arrêtera, donc définissez max_tokens conformément pour contrôler les coûts.

Les codes de statut HTTP courants incluent 401 pour les clés invalides, 402 pour le crédit insuffisant et 429 pour les limites de débit. Vous êtes limité à 300 requêtes par minute par clé. Ces contraintes garantissent une utilisation équitable pour tous les utilisateurs. Utilisez le 429 erreur à mettre en œuvre dans votre code client pour mettre en œuvre une rétrogradation exponentielle, garantissant un fonctionnement fluide pendant les périodes de fort trafic.