API DeepSeek : votre première requête

Récupérer les paramètres de connexion#

Utilisez les trois valeurs du même fournisseur. Une clé d’abonnement DeepSeek ABO ne donne pas automatiquement accès au point de terminaison officiel de DeepSeek.

Ouvrez Clés API pour trouver l’URL de base et le modèle actuels (deepseek-flash). Utilisez https://api.example.invalid/v1 comme URL de base. Avant toute requête, créez une clé et vérifiez que vous disposez d’un forfait actif ou de crédit API.

Définir les variables d’environnement#

macOS / Linux

Définissez les variables dans le terminal où vous exécutez le code. Un préfixe de version comme /v1 est nécessaire uniquement si le fournisseur le demande. Omettez la barre oblique finale.

export CODING_PLAN_API_KEY="your-api-key"
export CODING_PLAN_BASE_URL="https://your-provider.example/v1"
export CODING_PLAN_MODEL="deepseek-flash"

Windows PowerShell

$env:CODING_PLAN_API_KEY = "your-api-key"
$env:CODING_PLAN_BASE_URL = "https://your-provider.example/v1"
$env:CODING_PLAN_MODEL = "deepseek-flash"

Les variables d’environnement s’appliquent à la session de terminal en cours. Sur les deux plateformes, exécutez les exemples Python et Node.js dans le même terminal. L’exemple cURL utilise la syntaxe du shell de macOS et de Linux.

Envoyer une requête#

Choisissez un langage. Pour Python, exécutez python -m pip install openai. Pour Node.js, exécutez npm install openai et utilisez un fichier .mjs . Ces exemples envoient une courte requête qui peut consommer une partie de votre quota.

curl --fail-with-body "$CODING_PLAN_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CODING_PLAN_API_KEY" \
  -d "{\"model\":\"$CODING_PLAN_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Say hello in one sentence.\"}],\"stream\":false}"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CODING_PLAN_API_KEY"],
    base_url=os.environ["CODING_PLAN_BASE_URL"],
)
response = client.chat.completions.create(
    model=os.environ["CODING_PLAN_MODEL"],
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
    stream=False,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CODING_PLAN_API_KEY,
  baseURL: process.env.CODING_PLAN_BASE_URL,
});
const response = await client.chat.completions.create({
  model: process.env.CODING_PLAN_MODEL,
  messages: [{ role: "user", content: "Say hello in one sentence." }],
  stream: false,
});
console.log(response.choices[0].message.content);

Lire la réponse#

La réponse de l’assistant figure dans choices[0].message.content. Un extrait d'exemple est ci-dessous; le texte réel et les nombres de jetons peuvent différer.

{
  "choices": [{
    "message": { "role": "assistant", "content": "Hello! How can I help?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 8, "total_tokens": 20 }
}

Comparez les champs de consommation retournés avec les informations de Consommation et ton fenêtres de consommation. Les demandes ouvertes peuvent réserver temporairement des contingents ou des crédits jusqu'au décompte.

En cas d’erreur, utilisez le code HTTP et le message pour consulter le guide de dépannage. Vérifiez le chemin du point final avant de changer la clé.

Aller plus loin#

• Recevoir une réponse en streaming pour afficher le texte à l'arrivée.
• Poursuivre une conversation En envoyant l'historique des messages.
• Comprendre la consommation de jetons Avant de scaler les requêtes.
• Configurer & #160;: Claude Code, Codexou OpenCode.

Les clés de service et les données de connexion officielles font partie du service officiel. Modèles et compatibilité API à la distinction.