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.


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.
| Question | Documentation de DeepSeek | Cette API |
|---|---|---|
| URL de base | Documenté dans leur guide de démarrage rapide (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| Authentification | Jeton Bearer dans l'en-tête Authorization | Jeton Bearer dans l'en-tête Authorization |
| Nom du modèle | Listé dans la documentation de leurs modèles ; vérifiez les noms actuels | uncensored |
| Endpoint principal | Complétions de chat | Complétions de chat, Réponses, liste des modèles |
| Tarifs | Vé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_limitedouconcurrency. - Solde. Vérifiez le crédit avec
GET /v1/balance, la route des crédits de style OpenAI, ou l’en-têteX-Balance-USDsur 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.
- 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.
- 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.
- 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.
- 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. - Surveillez le coût. Journalisez
usagedepuis chaque réponse et comparez-le avec l’en-têteX-Balance-USDsur une journée de trafic. - 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.
Plus de guides
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.