Comment utiliser DeepSeek via une API compatible OpenAI
DeepSeek fournit déjà un endpoint de style OpenAI. La vraie question est où conserver l'URL de base, comment gérer les noms de modèles et quoi tester avant de déplacer le trafic de production.
Essayez Tokuse : créez un compte gratuit et envoyez votre première requête via un seul endpoint compatible OpenAI.
Ce guide utilise Tokuse comme exemple de passerelle, car son catalogue public liste deepseek-flash et deepseek-v4-pro et expose une API compatible OpenAI à l'adresse :
https://tokuse.com/v1
L'ensemble des modèles, les quotas et le prix affichés pour votre compte peuvent changer. Vérifiez le catalogue actuel avant le déploiement.
Ce que signifie « compatible OpenAI »
La compatibilité signifie que les SDK OpenAI existants peuvent généralement envoyer des requêtes en changeant simplement l'URL de base et le nom du modèle. Votre application peut conserver une structure client familière :
SDK -> OpenAI-compatible base URL -> model alias -> provider
La passerelle reçoit la requête, résout le modèle, attache les identifiants du fournisseur et renvoie une réponse normalisée. Les changements de fournisseur restent ainsi hors du code produit.
La compatibilité ne signifie pas que chaque paramètre spécifique à un fournisseur fonctionne de la même manière. Testez le streaming, les appels d'outils, la sortie JSON, les codes d'erreur et la comptabilisation des tokens avec le SDK et le modèle exacts que vous prévoyez d'utiliser.
Configuration Python
Installez le SDK OpenAI :
pip install openai
Définissez la clé Tokuse sur le serveur :
export TOKUSE_API_KEY="YOUR_KEY"
Utilisez ensuite l'interface chat completions habituelle :
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKUSE_API_KEY"],
base_url="https://tokuse.com/v1",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{
"role": "system",
"content": "Return a compact JSON object. Do not add commentary.",
},
{
"role": "user",
"content": "Extract the company name and plan from: Acme Pro, billed monthly.",
},
],
response_format={"type": "json_object"},
max_tokens=200,
)
print(response.choices[0].message.content)
Utilisez l'URL de base sans /chat/completions. Le SDK ajoute lui-même le chemin de l'endpoint.
Configuration Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKUSE_API_KEY,
baseURL: "https://tokuse.com/v1",
});
const response = await client.chat.completions.create({
model: "deepseek-flash",
messages: [
{
role: "user",
content: "Summarize this support ticket in one sentence.",
},
],
max_tokens: 120,
});
console.log(response.choices[0].message.content);
Gardez la clé dans des variables d'environnement côté serveur. Ne l'exposez pas dans les bundles navigateur, les applications mobiles ou les logs de build.
Choisir le modèle selon la tâche
Commencez par deepseek-flash pour l'extraction courante, la classification, les résumés et les étapes de workflow à fort volume. Testez deepseek-v4-pro sur les tâches de raisonnement complexe ou de long horizon où la route moins chère échoue à votre évaluation.
La décision de routage doit reposer sur la réussite de la tâche, pas sur le prestige du modèle. Comparez la qualité, la longueur de sortie, la latence, les nouvelles tentatives et le coût par tâche réussie.
La tarification des cache hits de DeepSeek rend les prompts stables particulièrement importants. Son tarif officiel en heures creuses est de $0.003/M en cache hit contre $0.15/M en cache miss ; sur Tokuse, les tarifs de base actuels de deepseek-flash sont de $0.274/M en entrée et $1.096/M en sortie, avec des cache hits autour de $0.006/M. Consultez le modèle complet de tarification et de cache DeepSeek avant de choisir un budget.
Testez ces modes d'échec
401 ou token invalide
Vérifiez que la clé appartient au compte de la passerelle et qu'elle ne contient pas d'espace parasite. Renouvelez la clé si elle a déjà été commitée ou journalisée.
404 sur chat completions
Vérifiez à la fois l'URL de base et le chemin du SDK. https://tokuse.com/v1 est l'URL de base. N'ajoutez pas le chemin /chat/completions du SDK, sauf si votre client HTTP attend un endpoint complet.
Modèle non pris en charge
Consultez le catalogue de modèles actuel ou le tableau de bord. Les alias de modèles peuvent varier selon le compte et la disponibilité. Un modèle qui fonctionnait pendant le pilote peut être désactivé plus tard.
429 ou erreurs de quota
Ajoutez un backoff exponentiel borné avec jitter. Ne réessayez pas indéfiniment. Distinguez les limites par minute des erreurs de solde de compte ou de quota.
Sortie tronquée
Vérifiez finish_reason, la limite de tokens de sortie et le schéma demandé. Une limite plus élevée peut augmenter le coût sans améliorer le résultat. Mesurez les deux.
Échecs de streaming
Enregistrez la latence du premier token et le point d'échec. Une fois que des tokens ont atteint l'utilisateur, une nouvelle tentative transparente peut dupliquer du texte. Préférez une erreur visible ou une continuation contrôlée.
Checklist de production
- Utilisez des clés distinctes pour le développement et la production.
- Ne livrez jamais de clés de fournisseur ou de passerelle dans le code client.
- Journalisez les ID de requête, le modèle, le statut, la latence, les tokens d'entrée, les tokens de sortie et le nombre de tentatives.
- Masquez les prompts, les réponses et les en-têtes d'autorisation dans les logs par défaut.
- Épinglez les alias de modèles et testez les changements avant le déploiement.
- Ajoutez des délais d'attente, des budgets de nouvelles tentatives et un kill switch.
- Comparez le coût par tâche réussie, pas le coût par requête.
- Commencez par un faible pourcentage du trafic et mesurez la qualité sur un jeu d'évaluation fixe.
Commencez avec un seul endpoint
Tokuse fournit un endpoint compatible OpenAI, un catalogue de modèles, une gestion de l'usage et un tableau de bord d'administration pour les équipes qui évaluent plusieurs modèles d'IA. Commencez par le catalogue actuel et une clé de test, puis faites passer une charge de travail à faible risque par la passerelle avant d'élargir.
Créez un compte Tokuse et inspectez les modèles actuels
Guides connexes sur les coûts et la migration
- Prix DeepSeek et modèle de coût des cache hits
- Expérience sur les prix DeepSeek en heures pleines et creuses
- Calculateur de coût DeepSeek
- Référence de l'API Chat Completions