Dernière mise à jour
Dolphin Dépannage IA : Erreurs courantes d'intégration API
Les échecs d'intégration de Dolphin AI découlent généralement d'IDs de modèle incorrects ou d'une mécompréhension de la manière dont les modèles non censurés gèrent le contexte et le streaming. Ce guide clarifie les contraintes techniques spécifiques de notre API compatible OpenAI pour éviter le gaspillage de crédits et les flux de travail asynchrones brisés.
Conclusions clés
- L'ID du modèle est strictement "uncensored", et non un nom de fournisseur générique.
- Les tokens d'entrée consomment 100k de contexte, mais la sortie est limitée à 16k tokens par requête.
- Le streaming via SSE est requis pour l'affichage en temps réel des jetons dans la plupart des UI.
- Le mode JSON nécessite une configuration explicite de response_format dans le corps de la requête.
Supposer que 'uncensored' signifie 'aucun filtre du tout'
Sans censure ne signifie pas que le modèle n'a aucune limite. Cela signifie spécifiquement que le modèle ne refusera pas les sujets adultes légaux, controversés ou créatifs que les modèles standards pourraient bloquer. Notre LLM sans censure accepte n'importe quelle invite sans moraliser, mais il applique toujours une limite de contenu stricte concernant les mineurs.
Par exemple, si vous demandez du contenu sexuel impliquant des mineurs, l'API renverra un refus indépendamment du paramètre sans censure. Il s'agit d'une règle stricte appliquée au niveau de l'inférence. Tout autre contenu adulte légal, y compris la fiction explicite ou les débats nuancés, passe sans filtres atténués.
Confusion entre fenêtre de contexte et tokens de sortie max
La fenêtre de contexte est de 100 000 tokens, mais le maximum de sortie par requête est de 16 000 tokens. Cette distinction est cruciale pour la génération de longs documents. Si vous envoyez une invite de 90k tokens et demandez 30k tokens, la requête échoue ou se tronque de manière inattendue.
- Contexte max : 100 000 tokens (entrée + sortie combinés).
- Sortie maximale : 16 000 tokens par requête.
- Sortie par défaut : 2 048 jetons si max_tokens n'est pas défini.
Définissez toujours max_tokens explicitement dans vos appels API. Cela empêche une utilisation incontrôlée des tokens et garantit une facturation prévisible. Les erreurs qui dépassent ces limites ne consomment pas de crédit, mais elles cassent votre logique de parsing.
Ignorer les réponses en streaming dans les environnements asynchrones
Notre API prend en charge le streaming via Server-Sent Events (SSE). Si vous utilisez un client synchrone pour une génération longue, vous atteindrez les limites de délai d'attente. Les environnements asynchrones attendent un flux de chunks partiels, et non une seule charge utile massive.
Chaque chunk inclut des données d'utilisation des tokens dans le dernier payload. Cela vous permet de suivre les coûts en temps réel. Sans streaming, votre interface utilisateur peut geler pendant plusieurs secondes lors d'une génération intensive. Utilisez le
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)Définir le mauvais ID de modèle dans le corps de la requête
De nombreux développeurs utilisent par défaut "gpt-3.5-turbo" ou "gpt-4". Notre API nécessite que l'ID du modèle soit exactement "uncensored". L'envoi de tout autre ID entraîne une erreur 404 ou modèle non trouvé. Ce n'est pas un modèle propriétaire comme GPT ou Claude.
C'est un modèle à poids ouverts fonctionnant sur notre infrastructure. Assurez-vous que la configuration de votre SDK pointe vers HTTPS://api.dolphinmodelai.com/v1 et utilise "uncensored" comme nom de modèle. C'est le seul modèle que nous servons.
Oublier de gérer les formats tool_choice et function calling
L'appel de fonctions est pris en charge, mais le format doit correspondre aux normes OpenAI. Vous devez spécifier explicitement tool_choice si vous souhaitez forcer l'utilisation des outils. L'API accepte les paramètres tools, tool_choice et les formats de message standard.
Des définitions d'outils mal formatées entraînent des erreurs d'analyse du côté du client. Assurez-vous que vos schémas JSON sont valides. Le modèle renvoie du JSON structuré que votre code doit analyser. Utilisez le
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinmodelai.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);Mécompréhension de la différence entre les tarifs des entrées et des sorties
Les jetons d'entrée coûtent 0,15 $ par 1M de jetons. Les jetons de sortie coûtent 0,50 $ par 1M de jetons. La sortie est quatre fois plus coûteuse que l'entrée. Ce ratio est standard pour la plupart des API LLM, mais il affecte significativement votre budget.
Le crédit prépayé est facturé en fonction de l'utilisation réelle des tokens. Les erreurs et les refus sont gratuits. Si vous envoyez une invite de 10k tokens et obtenez une réponse de 10k tokens, vous payez pour les deux. Les recharges en cryptomonnaies sont obligatoires. Vous pouvez recharger avec USDT sur TRC20 ou USDC sur Base. Le montant minimum de rechargement est de $20. Des bonus s'appliquent à $50 (+5%), $100 (+10%) et $200 (+15%).
Ne pas vérifier le format de réponse pour les erreurs de mode JSON
Le mode JSON nécessite que vous définissiez response_format sur {"type": "json_object"}. Sans cela, le modèle peut retourner du markdown ou du texte qui casse votre analyseur. C'est une source courante d'échecs d'intégration.
Assurez-vous que votre schéma est strict. Le modèle ne garantit pas un JSON parfait si le schéma est ambigu. Utilisez le
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinmodelai.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)Supposer que tous les paramètres du SDK OpenAI fonctionnent de manière identique
Des paramètres tels que temperature, top_p, stop, seed, presence_penalty et frequency_penalty fonctionnent de manière similaire à ceux d'OpenAI. Toutefois, tous les paramètres de cas limites ne sont pas pris en charge. Nous prenons en charge l'ensemble de base nécessaire à la plupart des cas d'utilisation.
Le streaming, l'appel de fonctions et le mode JSON sont entièrement pris en charge. Consultez le
curl https://api.dolphinmodelai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Run unit tests for the payment module"}]
}'Négliger la limite de corps de requête de 8 Mo
La taille maximale du corps de la requête est de 8 Mo. Si vous envoyez de grands fichiers ou un contexte étendu, vous pouvez dépasser cette limite. Il s'agit d'une contrainte stricte sur la passerelle API. Les requêtes dépassant cette taille sont rejetées immédiatement.
Assurez-vous que votre charge utile est compressée ou tronquée. Utilisez le
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)Questions fréquentes
Le modèle Dolphin AI est-il identique à l'API GPT officielle ?
Non. Nous sommes un service indépendant. Notre API est compatible OpenAI, ce qui signifie qu'elle utilise la même structure de point de terminaison et les mêmes SDK, mais elle sert un modèle sans censure différent. Ce n'est pas GPT, Claude ou le modèle d'aucun autre fournisseur. Vous devez modifier l'URL de base et l'identifiant du modèle pour l'utiliser.
Comment recharger mon crédit ?
Nous acceptons uniquement les cryptomonnaies : USDT sur TRC20 ou USDC sur Base. Le minimum de recharge est de 20 $. Les bonus sont de +5 % à 50 $, +10 % à 100 $ et +15 % à 200 $. Inscrivez-vous avec Google ou e-mail pour obtenir votre clé.
Le modèle sans filtre filtre-t-il tout le contenu ?
Non. Il ne filtre qu'une seule limite stricte : le contenu sexuel impliquant des mineurs. Tout autre contenu adulte licite, controversé ou créatif est autorisé sans refus. Cela le rend idéal pour la création de contenu NSFW et la fiction non restreinte.
Qu'est-ce que le crédit d'essai ?
Les nouveaux comptes reçoivent 0,50 $ de crédit d'essai valable 7 jours. C'est unique par personne. Les erreurs et les refus pendant l'essai ne consomment pas de crédit.
Obtenez votre clé API
Inscrivez-vous, copiez la clé, mettez à jour votre URL de base. C'est fait.
