FR ▾
Obtenir une clé API

deepseek4api.comGuide

Guide de la documentation API DeepSeek et alternative prête à l’emploi

La plupart des personnes qui ouvrent la documentation de l'API DeepSeek veulent les mêmes cinq réponses : l'URL de base, comment s'authentifier, quel nom de modèle utiliser, quels paramètres fonctionnent et à quoi ressemble un appel fonctionnel. Cette page couvre ces points, puis montre les mêmes appels adressés à un endpoint OpenAI compatible différent que vous pouvez intégrer.

Mis à jour le

Deux connecteurs correspondants joints par des blocs de code lumineux, illustrant un remplacement d’API prêt à l’emploi
Deux piles de pièces de différentes hauteurs alimentant un petit serveur, illustrant le prix des tokens en entrée et en sortie

Points clés

  • DeepSeek documente une API de style OpenAI, donc le SDK OpenAI fonctionne en modifiant l’URL de base, la clé et le nom du modèle.
  • Ce site n’est pas l’API officielle de DeepSeek ; il sert un seul modèle à poids ouverts indépendant sous l’ID uncensored.
  • Le même code fonctionne des deux côtés : seules trois valeurs changent.
  • La fenêtre de contexte est de 100 000 tokens, avec prise en charge du streaming, des outils et du mode JSON.

Les cinq éléments répondus par la documentation API DeepSeek

Lorsque les développeurs recherchent la documentation de l'API DeepSeek, ils essaient généralement d'effectuer une première requête. Le schéma est le même que pour tout service de style OpenAI, ce qui explique pourquoi un tableau facilite la comparaison.

QuestionDocumentation de DeepSeekCette API
URL de baseDocumenté dans leur guide de démarrage rapide (api.deepseek.com)https://api.deepseek4api.com/v1
AuthentificationJeton Bearer dans l'en-tête AuthorizationJeton Bearer dans l'en-tête Authorization
Nom du modèleListé dans la documentation de leurs modèles ; vérifiez les noms actuelsuncensored
Endpoint principalComplétions de chatComplétions de chat, Réponses, liste des modèles
TarifsVérifiez leurs tarifs actuels$0,15 / 1M tokens d'entrée, $0,50 / 1M tokens de sortie

Lisez les pages officielles de DeepSeek pour tout ce qui concerne leurs modèles, prix et limites ; ils évoluent, et cet article ne tente pas de les restituer. L’objectif est que la forme de la requête soit partagée, de sorte que le passage de l’un à l’autre est un changement de configuration.

Un point à clarifier : ce site n’est pas l’API officielle de DeepSeek, et il ne sert pas de routeur vers DeepSeek. Il s’agit d’un endpoint hébergé, compatible OpenAI, qui sert un modèle à poids ouverts unique géré par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour un usage adulte légal.

Étape 1 : authentification et URL de base

Créez un compte (Google, ou e-mail et mot de passe) et ouvrez la page clé API. Copiez la clé. Les nouveaux utilisateurs peuvent également réclamer 0,50 $ de crédit d’essai en un clic, valable 7 jours et sans besoin de carte.

Chaque requête inclut l’en-tête Authorization: Bearer YOUR_KEY. Avec curl :

curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Cela liste le modèle disponible, uncensored. Si vous copiez un exemple DeepSeek, remplacez trois éléments : l’URL de base, la clé et le nom du modèle. Rien d’autre ne doit changer.

Étape 2 : une complétion de chat en Python

Le SDK OpenAI est celui utilisé dans les exemples de la documentation DeepSeek, et il fonctionne ici sans modification :

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek4api.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain idempotency in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Les paramètres d’échantillonnage pris en charge, y compris temperature, top_p, stop, seed et les pénalités de présence et de fréquence, sont transmis. max_tokens est facultatif car la complétion peut utiliser tout ce qui reste de la fenêtre de 100 000 tokens.

Étape 3 : streaming, mode JSON et outils

Diffusion en continu

Définissez stream: true pour recevoir des événements envoyés par le serveur. L’utilisation est rapportée à la fin du flux.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseek4api.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about caching." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Mode JSON

Passez response_format: {"type": "json_object"} et mentionnez JSON dans votre prompt. La sortie est un objet JSON que vous pouvez analyser directement.

Appel de fonctions

Les paramètres tools et tool_choice fonctionnent au format OpenAI, les appels d’outils sont diffusés sous forme de deltas, et vous retournez les résultats en tant que messages avec role: "tool". Si votre code effectue déjà un appel de fonctions contre DeepSeek, il devrait être portable avec le changement de trois valeurs ci-dessus, mais testez vos propres schémas.

Où les deux diffèrent

Le même protocole ne signifie pas le même service. Points à vérifier lors du déplacement d’une charge de travail :

  • Comportement du modèle. Un modèle différent donne des réponses, un style de raisonnement et un comportement de refus différents. Relancez votre ensemble de prompts avant de modifier quoi que ce soit en production.
  • Champs spécifiques au raisonnement. Si vous dépendez de champs de réponse spécifiques au fournisseur d’un modèle DeepSeek particulier, ne supposez pas qu’ils existent ici. Les champs standard de complétion de chat, si.
  • Fonctionnalités non offertes. Cette API est textuelle uniquement : pas d'images, d'audio, de vidéo, d'embeddings ou de fine-tuning.
  • Limites. Une clé complète permet 8 requêtes simultanées et 300 par minute ; une clé d’essai en permet 2 et 60. Au-delà d’une limite, vous obtenez HTTP 429 avec rate_limited ou concurrency.
  • Solde. Vérifiez le crédit avec GET /v1/balance, la route des crédits de style OpenAI, ou l’en-tête X-Balance-USD sur chaque réponse.

Pour voir comment un utilisateur axé sur DeepSeek envisage le coût, consultez les notes sur les prix DeepSeek ; pour les configurations d’éditeur, le guide VS Code.

Le coût d’un appel ici

La facturation est prépayée et par token : 0,15 $ par 1M tokens d'entrée et 0,50 $ par 1M tokens de sortie. Une requête avec 1 500 tokens d'entrée et 600 tokens de sortie coûte 1 500 x 0,15 $ / 1M = 0,000225 $ pour l'entrée plus 600 x 0,50 $ / 1M = 0,0003 $ pour la sortie, soit un total de 0,000525 $. Un rechargement de 20 $ couvre environ 38 000 de ces requêtes.

Les rechargements acceptent tout montant entier de 20 $ à 500 $, avec +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Vous pouvez payer par crypto (USDT sur TRC20, USDC sur Base). Le crédit n’expire jamais, et les requêtes échouées ou refusées ne sont pas facturées. Détails sur la page des tarifs.

Une liste de contrôle de migration

Si vous portez une application qui communique déjà avec DeepSeek, parcourez ces étapes dans l’ordre. Chaque étape prend quelques minutes.

  1. Placez les trois valeurs dans la configuration. L’URL de base, la clé et le nom du modèle doivent provenir de variables d’environnement, et non de constantes dispersées dans le code.
  2. Exécutez un test de fumée. Une complétion de chat, une complétion en streaming, un appel en mode JSON et un appel d’outil. Les quatre extraits ci-dessus les couvrent.
  3. Rejouez de vrais prompts. Prenez 30 prompts de vos journaux et comparez les réponses côte à côte. Évaluez-les selon vos propres critères plutôt qu’un score générique.
  4. Gérez les 429. Ajoutez une nouvelle tentative avec backoff et respectez Retry-After. Une requête en streaming occupe son slot de concurrence jusqu’à la fin du flux, donc fermez les flux abandonnés.
  5. Surveillez le coût. Journalisez usage depuis chaque réponse et comparez-le avec l’en-tête X-Balance-USD sur une journée de trafic.
  6. Déployez progressivement. Envoyez d’abord 5 à 10 % du trafic vers le nouvel endpoint, puis augmentez-le.

Comparez le coût par tâche, et non le prix par token, car différents modèles utilisent un nombre différent de tokens pour la même tâche. Pour vérifier de manière ouverte le comportement des modèles d'écriture, l'article de jeu de rôle est un compagnon utile.

Choisir entre les deux

Utilisez l'API propre à DeepSeek lorsque vous avez spécifiquement besoin d'un modèle DeepSeek, de ses fonctionnalités fournisseur ou de son support officiel. Utilisez cet endpoint lorsque vous souhaitez un modèle hébergé compatible OpenAI qui répond sans refus de contenu pour une utilisation adulte légale, avec une facturation simple par crédit prépayé et des prompts qui ne sont pas utilisés pour l'entraînement. De nombreuses équipes voudront avoir les deux derrière un interrupteur de configuration, ce que le protocole partagé rend facile. La documentation de cette API se trouve dans la documentation.

Questions et réponses

S'agit-il de l'API officielle DeepSeek ?

Non. Il s’agit d’un endpoint indépendant compatible OpenAI qui sert un seul modèle à poids ouverts sous l’ID uncensored. Ce n’est pas le service DeepSeek et il n’effectue pas de routage vers celui-ci.

Puis-je réutiliser mon code DeepSeek ?

S’il utilise le SDK OpenAI ou le format chat completions, généralement oui. Modifiez l’URL de base, la clé et le nom du modèle, puis testez vos prompts.

Où trouver le nom du modèle ?

Appelez GET /v1/models. Cette API sert un seul modèle avec l’ID uncensored.

Quelle est la longueur de la fenêtre de contexte ?

100 000 tokens pour le prompt plus la complétion.

Jeton Bearer dans l'en-tête Authorization

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.