Documentation API Dolphin ai

Authentification et configuration de l'URL de base

Les clés API authentifient instantanément vos requêtes prépayées. Vous recevez une clé active par compte, remplaçant toute clé précédente lors de la génération. L'URL de base pointe vers le service hébergé.

• URL de base : HTTPS://api.aidolphin.cc/v1
• En-tête : Authorization: Bearer YOUR_API_KEY

Copycurl https://api.aidolphin.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source inference engines"}]
  }'

Envoi d'une demande de complétion de chat basique

Envoyez des payloads JSON standards au point de terminaison des complétions de chat. L’ID du modèle est toujours « uncensored » pour une sortie textuelle cohérente. Les tokens d’entrée coûtent $0.15 par million, tandis que les tokens de sortie coûtent $0.50 par million.

• Modèle : uncensored
• Sortie maximale : 16 000 tokens

Copyfrom openai import OpenAI

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

Réponses en streaming avec les Server-Sent Events

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie des données via des événements envoyés par le serveur (SSE) pour la livraison en temps réel des jetons. Les détails d'utilisation des jetons apparaissent dans le dernier fragment du flux.

Copyimport OpenAI from "openai";

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

Activation du mode JSON pour les données structurées

Utiliser response_format défini à {"type": "json_object"} pour forcer une sortie structurée. Cela garantit que le modèle retourne un JSON valide sans formatage markdown supplémentaire. L'appel de fonctions et les définitions d'outils s'appuient également sur cette structure JSON.

Configuration de la température, du top_p et des séquences d'arrêt

Ajustez les paramètres d'échantillonnage pour contrôler l'aléatoire et la longueur de la sortie. Définissez temperature pour la créativité, top_p pour l'échantillonnage par noyau, et stop séquences pour tronquer la sortie prématurément. Les pénalités de présence et de fréquence aident à réduire les répétitions.

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)

Comprendre les limites de débit et les quotas

Chaque clé API permet 300 requêtes par minute et 8 requêtes simultanées. La taille maximale du corps de requête est de 8 Mo. Les erreurs et les refus ne consomment pas votre crédit prépayé. Si vous dépassez les limites, vous recevez un code d'état 429.