Accès à l’API DeepSeek via un routeur compatible OpenAI

L’accès à l’API DeepSeek via un routeur compatible OpenAI est un schéma de configuration pratique pour les indie hackers qui veulent utiliser les modèles DeepSeek sans transformer chaque choix de fournisseur en une nouvelle intégration SDK.

Vous avez deux chemins propres. Le chemin direct DeepSeek utilise une clé API DeepSeek, l’URL de base compatible OpenAI de DeepSeek et un nom de modèle DeepSeek. Le chemin via routeur utilise l’URL de base compatible OpenAI de Flatkey, une clé API Flatkey et l’ID de modèle DeepSeek disponible pour votre compte. Les deux peuvent fonctionner. Le bon choix dépend du fait que DeepSeek soit votre seule famille de modèles ou seulement un itinéraire parmi d’autres dans un produit multi-modèles.

Ce guide montre comment configurer l’accès à l’API DeepSeek via un routeur compatible OpenAI, comment garder le chemin direct du fournisseur facile à déboguer et ce qu’il faut vérifier avant de faire passer le trafic en production.

Réponse rapide : accès à l’API DeepSeek via un routeur compatible OpenAI

Pour une application de type OpenAI, l’accès à l’API DeepSeek a deux itinéraires pratiques.

Utilisez l’itinéraire direct lorsque DeepSeek est le seul modèle dont vous avez besoin et que le contrôle au niveau du fournisseur est le plus important. Utilisez Flatkey lorsque DeepSeek s’ajoute à GPT, Claude, Gemini, Qwen, des modèles médias ou des routes d’agent de codage derrière le même client compatible OpenAI.

Ce que DeepSeek confirme sur la compatibilité API

La documentation API actuelle de DeepSeek indique que l’API DeepSeek utilise un format d’API compatible avec OpenAI et Anthropic. L’URL de base au format OpenAI est :

https://api.deepseek.com

DeepSeek documente également une URL de base au format Anthropic :

https://api.deepseek.com/anthropic

La même documentation répertorie deepseek-flash et deepseek-v4-pro comme options de modèle. Elle précise aussi que les anciens noms deepseek-v4-flash et deepseek-v4-flash-vision-exp sont toujours acceptés pour des raisons de compatibilité, mais que ces requêtes sont servies par DeepSeek-V4.1-Flash et facturées au prix Flash. Pour du nouveau code, considérez les anciens noms comme un risque de migration, et non comme des noms à copier dans un nouveau produit.

La page de tarification de DeepSeek décrit actuellement deepseek-flash comme DeepSeek-V4.1-Flash et deepseek-v4-pro comme DeepSeek-V4-Pro-0813. Elle indique également une longueur de contexte de 1M et un maximum de 384K en sortie, avec la prise en charge de la sortie JSON, des appels d’outil, de l’API Responses et de l’API Anthropic pour les deux modèles. La prise en charge de la vision est indiquée pour Flash et non pour Pro. Vérifiez la page de tarification DeepSeek en direct avant de publier des prix exacts dans votre propre documentation, car le tableau utilise des tarifs de jetons en heure de pointe et hors pointe.

Ce que Flatkey change

Flatkey ne supprime pas la nécessité de choisir un identifiant de modèle DeepSeek valide. Cela change l’endroit où la route est configurée et celui où vous vérifiez le résultat.

Le guide de démarrage rapide et la documentation de l’API des modèles de Flatkey utilisent cette URL de base compatible OpenAI :

https://router.flatkey.ai/v1

L’endpoint /v1/models de Flatkey renvoie les identifiants de modèle disponibles pour votre compte dans un format compatible OpenAI. La documentation d’utilisation de Flatkey indique que chaque requête peut être examinée avec le modèle utilisé, les nombres de jetons d’entrée et de sortie, le coût, l’horodatage, la clé API et le statut. Cela facilite l’exploitation de DeepSeek API Access Through an OpenAI-Compatible Router lorsque DeepSeek n’est qu’un candidat parmi plusieurs modèles.

La version routeur de l’enregistrement de route doit être explicite :

deepseek_route:
  provider_access_layer: flatkey
  base_url: https://router.flatkey.ai/v1
  api_key_source: FLATKEY_API_KEY
  candidate_models:
    - deepseek-flash
    - deepseek-v4-pro
  verify_before_launch:
    - account_accessible_v1_models
    - live_model_directory
    - pricing_page_units
    - usage_log_readback
    - fallback_or_rollback_policy

Ne cachez pas le nom du modèle sous forme de chaîne dans le code de l’application. Placez-le dans un fichier de configuration ou un manifeste de modèle afin qu’une mise à jour de modèle DeepSeek soit une modification révisable plutôt qu’un déploiement d’urgence.

Étape 1 : choisir DeepSeek direct ou un routeur

Commencez par la décision d’exploitation, pas par le SDK.

Pour la plupart des indie hackers, la première version peut être simple. DeepSeek direct convient pour un prototype à modèle unique. DeepSeek API Access Through an OpenAI-Compatible Router est plus propre une fois que le produit compare des modèles, exécute des agents de codage, sert des clients avec des besoins différents en latence ou en coût, ou a besoin d’un endroit unique pour déboguer l’utilisation des jetons.

Étape 2 : configurer le client OpenAI de Flatkey

Si votre projet utilise déjà le SDK OpenAI, la configuration du routeur se résume principalement à un changement d’URL de base et de clé.

Python :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

Node.js :

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FLATKEY_API_KEY,
  baseURL: "https://router.flatkey.ai/v1",
});

La version directe de DeepSeek utilise la même forme de client de type OpenAI, mais pointe vers DeepSeek :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

Conservez les deux clés dans des variables d’environnement ou un stockage sécurisé des secrets. Ne validez jamais FLATKEY_API_KEY, DEEPSEEK_API_KEY ni un remplacement de staging dans le dépôt.

Étape 3 : Vérifier l’ID du modèle avant la première requête

L’accès à l’API DeepSeek via un routeur compatible OpenAI doit commencer par la découverte du modèle, et non par une chaîne de modèle copiée.

Pour Flatkey, demandez au routeur quels ID de modèles votre compte peut utiliser :

curl https://router.flatkey.ai/v1/models \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

Confirmez ensuite le candidat dans le répertoire de modèles Flatkey en production et sur la page de tarification. Pour DeepSeek en direct, confirmez le nom du modèle dans la documentation DeepSeek et sur la page de tarification. À la date de cette vérification de la source, la documentation de DeepSeek oriente le nouveau code vers deepseek-flash et deepseek-v4-pro, tout en précisant que les anciens alias V4 Flash sont des noms de compatibilité.

Créez un petit manifeste :

models:
  deepseek_default:
    id: deepseek-flash
    route: flatkey
    base_url: https://router.flatkey.ai/v1
    use_for:
      - coding_assistant
      - structured_extraction
      - long_context_review
    owner: product_engineering
    rollback: previous_production_model

Il s’agit du registre de révision de la route DeepSeek. Il vous offre un emplacement pour enregistrer l’ID du modèle, le responsable de la route, le cas d’usage et la cible de retour arrière avant que le trafic de production ne dépende de la route. Conservez-le avec votre checklist de publication afin que l’accès à l’API DeepSeek via un routeur compatible OpenAI reste vérifiable après le lancement.

Étape 4 : Effectuer un premier chat completion

Commencez par une requête courte et déterministe. Il s’agit d’un test de route, pas d’un benchmark.

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Renvoyez des conseils de mise en œuvre concis."},
        {"role": "user", "content": "Expliquez pourquoi la configuration de base_url est importante en une phrase."},
    ],
    temperature=0.2,
    max_tokens=120,
)

print(response.choices[0].message.content)

Si la requête échoue, vérifiez dans cet ordre :

Cet ordre évite une erreur de débogage courante : traiter des échecs de configuration comme des échecs de modèle.

Étape 5 : Testez les fonctionnalités réellement utilisées par votre application

Compatible avec OpenAI ne signifie pas que chaque fournisseur, modèle ou chemin de routeur se comporte de manière identique. Testez les fonctionnalités qui comptent pour votre charge de travail.

Après chaque test Flatkey, ouvrez les journaux d’utilisation. La requête doit afficher le modèle attendu, les décomptes de jetons, le statut, l’horodatage, la clé API, la latence et le coût. Si rien n’apparaît, confirmez le base URL et la clé réellement utilisés par la requête.

Étape 6 : Normalisez le coût par sortie acceptée

Les prix publics des jetons de DeepSeek peuvent sembler attractifs, mais le prix des jetons n’est qu’une partie du coût de production. Comparez par sortie acceptée.

Utilisez cette grille :

La formule pratique :

accepted_output_cost =
  (successful_request_cost + retry_cost + fallback_cost + human_repair_cost)
  / accepted_outputs

Utilisez la page de tarification en direct de DeepSeek pour les unités directes du fournisseur. Utilisez la page de tarification en direct de Flatkey et vos journaux d’utilisation pour les frais liés au chemin du routeur. Ne copiez pas une ligne de prix statique dans la documentation de l’application sans date vérifiée ni responsable de la mise à jour.

Étape 7 : ajouter une politique de retour arrière

L’accès à l’API DeepSeek via un routeur compatible OpenAI doit pouvoir être annulé avant que les utilisateurs n’en dépendent.

deepseek_rollout:
  environment: production
  default_model: deepseek-flash
  route: flatkey
  start_percentage: 10
  increase_when:
    - accepted_output_rate >= 0.95
    - p95_latency_ms <= 4500
    - error_rate <= 0.02
    - usage_log_present: true
    - accepted_output_cost_within_budget: true
  rollback_when:
    - error_rate > 0.05
    - schema_failures_above_threshold: true
    - usage_log_missing: true
    - unexpected_cost_spike: true
  rollback_action:
    set_model: previous_production_model
    notify: engineering_owner

Cette politique ne nécessite pas d’équipe plateforme. Elle nécessite un responsable de route, un manifeste de modèle, une habitude de revue de l’utilisation et un test de préproduction avant d’augmenter le trafic.

Où cela s’intègre dans Flatkey

Flatkey convient lorsque DeepSeek fait partie d’un flux de routage de modèles plus large :

• Vous utilisez déjà des SDK compatibles OpenAI et souhaitez une seule URL de base pour plusieurs familles de modèles.
• Vous avez besoin de clés ou de quotas distincts pour le développement, la préproduction, la production ou les agents de codage.
• Vous souhaitez faire examiner DeepSeek, Qwen, Gemini, Claude, GPT et d’autres modèles via un seul catalogue de modèles et un seul flux de travail d’utilisation.
• Vous avez besoin d’un chemin de retour arrière lorsqu’un identifiant de modèle, une unité de prix, une fonctionnalité ou un routeur de fournisseur change.

Commencez avec le guide de démarrage rapide de l’API Flatkey, utilisez le guide de migration vers une alternative à l’API OpenAI si vous remplacez des appels directs au fournisseur, et associez cette liste de contrôle aux vérifications de routage API DeepSeek vs Qwen lorsque des charges de travail sensibles aux coûts comparent des fournisseurs régionaux.

Pour les décisions de production, consultez le répertoire de modèles Flatkey en direct, la page de tarification et la page d’état. Pour le comportement des modèles DeepSeek et la tarification directe du fournisseur, consultez la documentation de l’API DeepSeek et la page de tarification le jour du déploiement.

Liste de contrôle finale pour l’accès à l’API DeepSeek via un routeur compatible OpenAI

Avant de mettre l’accès à l’API DeepSeek à disposition des utilisateurs, vérifiez :

• Le ID du modèle est à jour dans la documentation DeepSeek et dans la liste des modèles accessibles depuis le compte Flatkey.
• Les tests directs DeepSeek utilisent https://api.deepseek.com et une clé API DeepSeek.
• Les tests du routeur Flatkey utilisent https://router.flatkey.ai/v1 et une clé API Flatkey.
• Vous n’utilisez pas deepseek-v4-flash ni deepseek-v4-flash-vision-exp comme nouveau nom de modèle de production.
• Le chat, le streaming, la sortie JSON, les appels d’outils, le long contexte et la vision sont testés séparément lorsque votre application en a besoin.
• Les journaux d’utilisation affichent le ID du modèle attendu, le statut, les nombres de jetons, l’horodatage, la latence, la clé API et le coût.
• Le coût est normalisé par la sortie acceptée, et non uniquement par le tarif nominal des jetons.
• Le retour arrière est un changement de configuration, pas une réécriture d’urgence du code.
• Les clés des fournisseurs sont stockées dans des variables d’environnement ou un stockage sécurisé, jamais dans le code.

DeepSeek API Access Through an OpenAI-Compatible Router est un modèle d’intégration simple lorsque l’itinéraire est explicite. Utilisez DeepSeek directement lorsque vous n’avez besoin que de DeepSeek. Utilisez Flatkey lorsque DeepSeek s’inscrit dans un produit multi-modèles qui nécessite un seul client, une seule URL de base, une seule boucle d’utilisation et un chemin de retour arrière propre.

Frequently Asked Questions

Does DeepSeek support the OpenAI API?

La documentation actuelle de DeepSeek indique que l’API DeepSeek utilise un format d’API compatible avec OpenAI et Anthropic. L’URL de base au format OpenAI est https://api.deepseek.com.

What is the Flatkey base URL for DeepSeek API access?

Utilisez https://router.flatkey.ai/v1 pour l’API compatible OpenAI de Flatkey. Choisissez ensuite un ID de modèle DeepSeek actuel à partir de la réponse /v1/models accessible depuis votre compte et du répertoire de modèles Flatkey en direct.

Can I use the same OpenAI SDK for DeepSeek through Flatkey?

Oui. Configurez le SDK OpenAI avec une clé API Flatkey et https://router.flatkey.ai/v1 comme URL de base. La requête conserve la structure familière de Chat Completions pour les modèles compatibles.

Which DeepSeek model name should new code use?

Vérifiez la documentation DeepSeek en direct avant la mise en production. À cette vérification de la source, DeepSeek liste deepseek-flash et deepseek-v4-pro ; elle indique que les anciens noms V4 Flash sont acceptés pour la compatibilité mais servis par DeepSeek-V4.1-Flash.

Should I publish exact DeepSeek prices in my own app docs?

Seulement si vous incluez la date de vérification et le responsable de la mise à jour. La page de tarification de DeepSeek utilise des tarifs de jetons en heure de pointe et hors pointe, et la disponibilité du routage Flatkey ou les unités de tarification doivent être vérifiées sur les pages de tarification et de modèles en direct de Flatkey.