Guide d'intégration : clé API deepseek coder
Utilisez une clé API deepseek coder pour acheminer les appels SDK OpenAI standard vers notre endpoint sans censure. Ce guide couvre l'URL de base, l'authentification et la configuration du streaming pour vos outils de codage.
URL de base et authentification
Votre clé API authentifie chaque requête. Définissez l'URL de base sur https://api.deepseekcoderapikey.com/v1 dans la configuration de votre client. Cette URL gère à la fois les points de terminaison de complétion de chat et de modèles sans nécessiter de segments de chemin supplémentaires. Vous recevez une seule clé par compte, et la génération d'une nouvelle clé remplace immédiatement la clé précédente.
Stockez la clé dans une variable d'environnement nommée DEEPSEEK_API_KEY ou le passer directement à votre client SDK. Le point de terminaison accepte les en-têtes standard, vous pouvez donc changer de fournisseur en modifiant uniquement l'URL de base et la valeur de la clé. Cette approche fonctionne avec Cursor, les extensions VS Code et les outils de développement locaux qui attendent une interface compatible OpenAI.
L'authentification échoue avec un statut 401 si la clé est manquante ou invalide. Utilisez le exemple pour vérifier la connectivité avant de l'intégrer dans la logique de votre application.curl https://api.deepseekcoderapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
}'
Point de terminaison Chat Completions (POST)
Envoyez des messages au POST /v1/chat/completions point de terminaison utilisant l'ID du modèle uncensored. Ce point de terminaison traite l’entrée textuelle et renvoie une sortie textuelle, prenant en charge les réponses synchrones et en streaming. Vous pouvez configurer le comportement du modèle à l’aide de paramètres tels que la température, le top_p et les séquences d’arrêt.
La fenêtre de contexte permet jusqu'à 100 000 tokens pour l'invite et la complétion combinées. Si vous ne spécifiez pas de limite max_tokens, le modèle utilise par défaut 2 048 tokens par requête. Utilisez le snippet pour voir comment structurer une requête de chat standard avec le SDK Python officiel d'OpenAI.from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekcoderapikey.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)
Les erreurs telles que le crédit insuffisant renvoient un code de statut 402, tandis que les requêtes malformées renvoient 400. Consultez le corps de la réponse pour des messages d'erreur détaillés afin de déboguer rapidement la structure de votre payload.
Point de terminaison Models (GET)
Interrogez les modèles disponibles en envoyant un GET /v1/models requête. Ce point de terminaison renvoie une liste d'objets modèle, y compris le uncensored ID du modèle. Vous pouvez utiliser ce point de terminaison pour vérifier que votre clé API est valide et que le service est en ligne avant d'effectuer des requêtes à fort volume.
La réponse inclut des métadonnées telles que l'ID du modèle, le type d'objet et les informations de propriété. Utilisez ces données pour configurer dynamiquement votre application ou pour journaliser les modèles disponibles à des fins de débogage. Le point de terminaison ne nécessite pas de corps, uniquement l'en-tête d'authentification standard.
Intégrer cette vérification dans votre séquence de démarrage garantit que votre application échoue rapidement si l'API est inaccessible. Cela vous aide également à vérifier que l'URL de base est correctement configurée avant de procéder aux véritables complétions de chat.
Réponses en streaming (SSE)
Activez le streaming en définissant le stream parameter à true dans votre requête. L'API retourne un flux Server-Sent Events (SSE), délivrant les jetons au fur et à mesure de leur génération. Cette approche réduit la latence perçue pour les assistants de code et permet des mises à jour de l'interface utilisateur en temps réel dans votre application.
Chaque chunk contient du contenu partiel, et le dernier chunk inclut les statistiques complètes d'utilisation des jetons. Analysez soigneusement le flux SSE pour gérer les interruptions réseau et tamponner les jetons partiels. Le exemple montre comment gérer le flux en JavaScript.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)
Le streaming est idéal pour la génération de code de longue forme ou des explications détaillées. Il offre une expérience utilisateur plus fluide par rapport à l'attente de la réponse complète. Assurez-vous que votre client gère correctement l'événement de fin de flux pour finaliser la réponse.
Appel de fonction et mode JSON
Utilisez l'appel de fonctions pour permettre au modèle d'invoquer des outils externes. Définissez vos fonctions dans le tools parameter et spécifiez le tool_choice pour contrôler quand le modèle les utilise. L'API prend en charge les définitions d'outils standards, vous permettant de vous intégrer à vos propres services backend.
Pour les sorties structurées, activez le mode JSON en définissant response_format à json_object. Cela force le modèle à renvoyer du JSON valide, ce qui est utile pour analyser les données de configuration ou les réponses d'API. Le le snippet montre comment configurer le mode JSON en Node.js.import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekcoderapikey.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);
Combinez l'appel de fonctions avec le streaming pour une utilisation interactive des outils. Le modèle peut invoquer plusieurs outils en un seul tour, permettant des workflows multi-étapes complexes. Assurez-vous que votre client gère correctement la sortie des outils pour maintenir le contexte de la conversation.
Limites de débit et contraintes
Votre clé API est limitée à 300 requêtes par minute et 8 requêtes simultanées. La taille maximale du corps de la requête est de 8 Mo. Si vous dépassez ces limites, l'API renvoie une erreur 429 Too Many Requests. Implémentez une rétrogradation exponentielle dans votre client pour gérer les limites de taux avec élégance.
Les erreurs comme 401 indiquent une clé invalide, tandis que 402 signale un crédit insuffisant. Les remboursements ne sont pas émis pour le crédit, mais les doubles facturations peuvent être résolues via la page Support. Le crédit n'expire jamais, vous pouvez donc recharger quand vous le souhaitez.
La fenêtre de contexte de 100 000 tokens s'applique à l'invite et à la complétion totales. Surveillez votre utilisation de tokens pour rester dans le budget. Utilisez le système de crédit prépayé pour ne payer que ce que vous utilisez, sans frais mensuels ni abonnements.
Questions fréquentes
Comment obtenir ma clé API DeepSeek Coder ?
Inscrivez-vous sur la page Obtenir la clé API à l'aide de Google ou de votre adresse e-mail. Votre clé s'affiche immédiatement après l'inscription. Aucun numéro de téléphone n'est requis et la clé est valide pour tous les points de terminaison.
Quelle est la taille de la fenêtre de contexte ?
La fenêtre de contexte est de 100 000 tokens pour l'invite et la complétion combinés. Le maximum de sortie par requête est de 16 000 tokens, ou 2 048 si max_tokens n'est pas défini.
Puis-je utiliser la cryptomonnaie pour recharger mon crédit ?
Oui, vous pouvez recharger avec USDT (TRC20) ou USDC (Base). Le rechargement minimum est de $20, et des bonus s'appliquent pour les montants plus élevés. Le crédit n'expire jamais.
La génération de clé prend quelques secondes
Inscrivez-vous, copiez votre clé, et mettez à jour votre URL de base. C'est tout.