Liste de vérification de migration DeepSeek V4 : remplacez les alias obsolètes en toute sécurité

La migration DeepSeek V4 n’est plus une tâche générique de « mise à niveau vers V4 ». Au 16 septembre 2026, le risque de migration est spécifique : DeepSeek indique que les noms hérités deepseek-v4-flash et deepseek-v4-flash-vision-exp sont toujours acceptés pour des raisons de compatibilité, mais que ces noms de modèles retirés sont servis par DeepSeek-V4.1-Flash et facturés au prix Flash. DeepSeek indique également que le service API pour deepseek-v4-pro se poursuit après le 14 septembre 2026, avec la méthode de facturation existante, sauf nouvel avis de DeepSeek.

Cela signifie que la voie sûre n’est pas de courir après chaque alias historique. La voie sûre consiste à standardiser le nouveau travail sur deepseek-flash, à documenter où deepseek-v4-pro est encore utilisé intentionnellement, et à vérifier le chemin exact appelé par votre produit. Si vous passez par Flatkey, le même principe s’applique : gardez le client compatible OpenAI pointé vers https://router.flatkey.ai/v1, choisissez la ligne DeepSeek actuelle dans le catalogue en direct, exécutez un test de fumée et confirmez les journaux d’utilisation avant le passage du trafic de production.

Ce guide Liste de vérification de migration DeepSeek V4 : remplacez les alias obsolètes en toute sécurité propose aux indie hackers et aux petites équipes de produits IA un déploiement pratique : auditer les alias obsolètes, mettre à jour les identifiants de modèle, tester le mode de réflexion, valider l’API Responses et le comportement des appels d’outils, vérifier les unités tarifaires et garder une procédure de retour en arrière simple.

Réponse rapide : que faut-il changer ?

Utilisez deepseek-flash comme nom actuel du modèle Flash. Traitez deepseek-v4-flash et deepseek-v4-flash-vision-exp comme des alias de compatibilité qui doivent être retirés du nouveau code, des politiques de routage, de la documentation et des feuilles d’évaluation. Ne conservez deepseek-v4-pro que lorsque vous avez une raison de tester et de surveiller directement la route Pro.

La règle pratique de migration DeepSeek V4 est simple : les alias appartiennent à un rapport d'audit, pas à une nouvelle configuration de production.

Pourquoi cette migration est différente de la liste de vérification de juin

La version originale de cet article se concentrait sur une retraite en juillet 2026 de deepseek-chat et deepseek-reasoner. Ce n'est plus le cadre le plus sûr pour cette page. La documentation officielle actuelle de DeepSeek met l'accent sur la version V4.1 Flash, le nom de modèle deepseek-flash, les alias Flash et Flash Vision retirés, ainsi que la note de service API toujours en vigueur pour deepseek-v4-pro.

Pour une petite équipe, cela change le plan de migration. Vous n'avez pas besoin de réécrire frénétiquement chaque mention liée à DeepSeek. Vous avez besoin d'un nettoyage contrôlé des alias avec des preuves datées :

• Quelles chaînes de modèle existent encore dans le code, les variables d'environnement, les jobs d'évaluation et la documentation ?
• Quelles chaînes sont des alias de compatibilité et quelles chaînes sont des identifiants de modèle actuels ?
• Quels itinéraires sont des routes DeepSeek directes et lesquels passent par Flatkey ou une autre passerelle ?
• Quelles charges de travail dépendent de la vision, du raisonnement, de l'API Responses, des appels d'outils, de la sortie structurée, du long contexte ou du streaming ?
• Quels tableaux de bord prouvent que le nouvel identifiant de modèle gère réellement le trafic ?

C'est la différence entre le remplacement d'un alias et une migration DeepSeek V4 fiable.

Faits sources à verrouiller avant de modifier le code

Avant de modifier les chaînes de modèle, enregistrez une brève note de migration avec la date de la source et les pages exactes que vous avez consultées. Pour cette actualisation, les faits sources sont :

Ne collez pas de chiffres de tarification dans la documentation de l’application sans horodatage. La page de tarification actuelle de DeepSeek affiche les prix par million de jetons, distingue les jetons d’entrée avec cache-hit, d’entrée avec cache-miss et de sortie, et indique les plages de pointe et hors pointe. Cela suffit pour justifier de vérifier la tarification en direct au moment du déploiement au lieu de s’appuyer sur une estimation statique dans le script de migration.

DeepSeek direct versus routage Flatkey

Une migration DeepSeek V4 peut être directe, acheminée via Flatkey, ou les deux pendant les tests.

Flatkey est utile lorsque le problème opérationnel dépasse une seule route DeepSeek : clés de fournisseur dispersées, modifications répétées du SDK, coût au niveau de la requête peu clair et décisions de repli difficiles à auditer. Mais une passerelle ne supprime pas la nécessité de prouver l’ID du modèle. Testez toujours la ligne exacte du modèle que votre compte appellera.

Checklist de migration DeepSeek V4

Utilisez cette checklist avant de remplacer les alias en production.

1. Figez la date source. Notez la date à laquelle vous avez consulté la documentation DeepSeek, la documentation Flatkey, le répertoire des modèles Flatkey, la tarification et l’état des routes. Pour cette mise à jour de l’article, cette date est le 16 septembre 2026.
2. Parcourez toute la pile. Recherchez deepseek-v4-flash, deepseek-v4-flash-vision-exp, deepseek-flash, deepseek-v4-pro, ainsi que les anciennes documentations qui indiquent aux développeurs de copier une valeur obsolète.
3. Classez chaque occurrence. Séparez le code de production, les configurations de préproduction, les jobs d’évaluation, les politiques de prompt-router, la documentation client, les macros de support, les notebooks, les fixtures CI et les exemples.
4. Remplacez les alias Flash obsolètes. Faites passer deepseek-v4-flash et deepseek-v4-flash-vision-exp à deepseek-flash seulement après avoir un route de test et un plan de retour arrière.
5. Gardez Pro explicite. Ne déplacez pas silencieusement les charges de travail deepseek-v4-pro vers Flash. Si Pro reste utilisé, indiquez le responsable, la raison, la date de vérification et le modèle de repli.
6. Rendez le mode de réflexion explicite. La documentation DeepSeek indique que le mode de réflexion est activé par défaut avec un effort par défaut high. Si vous avez besoin d’un comportement sans réflexion, configurez-le et testez-le explicitement.
7. Testez l’entrée d’image si vous avez utilisé l’alias vision. Pour les charges de travail qui utilisaient deepseek-v4-flash-vision-exp, exécutez les tests d’entrée d’image via la route que vous allez réellement déployer.
8. Testez séparément l’API Responses. La compatibilité de l’API Responses de DeepSeek inclut des champs pris en charge, partiellement pris en charge, ignorés et non pris en charge. N’inférez pas le comportement à partir de Chat Completions seul.
9. Exécutez les tests d’appel d’outils et de sortie structurée. Validez les schémas d’outils, les arguments de fonction, l’analyse JSON, les tentatives et le comportement multi-tour.
10. Vérifiez le streaming et l’utilisation. Confirmez la forme des chunks, la gestion des délais d’expiration, l’utilisation finale, les décomptes de jetons et les champs de facturation dans les journaux directs du fournisseur ou les journaux d’utilisation Flatkey.
11. Mettre à jour la documentation et les exemples. Supprimez les extraits obsolètes qui réintroduiraient des alias obsolètes lors de la prochaine intégration ou du prochain correctif.
12. Déployez derrière une configuration. Placez le modèle cible dans une variable d’environnement ou une table de routage. Évitez les littéraux codés en dur dans la logique métier.
13. Surveillez la première tranche de production. Commencez avec un trafic à faible risque, comparez le taux de sortie acceptée et le coût par réponse acceptée, puis n’augmentez la cadence qu’une fois les journaux propres.

Modèle d’audit d’alias à copier

Utilisez ce modèle comme un court enregistrement de migration. Conservez-le dans votre dépôt, votre outil de suivi des tickets ou votre runbook afin que les corrections futures sachent pourquoi l’alias a changé.

deepseek_v4_migration:
  checked_at_utc: "2026-09-16T00:00:00Z"
  source_pages:
    - "https://api-docs.deepseek.com/"
    - "https://api-docs.deepseek.com/quick_start/pricing"
    - "https://api-docs.deepseek.com/news/news260910"
    - "https://api-docs.deepseek.com/guides/thinking_mode"
    - "https://api-docs.deepseek.com/guides/responses_api"
    - "https://docs.flatkey.ai/quickstart.md"
    - "https://docs.flatkey.ai/guides/openai-sdk.md"
  replacements:
    - from: "deepseek-v4-flash"
      to: "deepseek-flash"
      reason: "alias Flash hérité ; la route est fournie par V4.1 Flash pour des raisons de compatibilité"
      owner: "engineering"
      status: "test_before_merge"
    - from: "deepseek-v4-flash-vision-exp"
      to: "deepseek-flash"
      reason: "alias hérité de l’expérimentation vision ; vérifier le comportement d’entrée d’image"
      owner: "engineering"
      status: "test_before_merge"
  intentionally_kept:
    - model: "deepseek-v4-pro"
      reason: "La route Pro est toujours évaluée intentionnellement"
      next_review_date: "2026-09-30"
  required_tests:
    - plain_chat
    - thinking_enabled
    - thinking_disabled_if_used
    - responses_api
    - image_input_if_used
    - tool_calls
    - json_output
    - streaming
    - usage_log_readback
    - rollback

Modèle de configuration Flatkey

La configuration Flatkey la plus sûre conserve la sélection du modèle spécifique au fournisseur dans la configuration, tandis que la surface du client compatible OpenAI reste stable.

FLATKEY_API_KEY="sk-your-flatkey-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-flash"

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model=os.environ.get("FLATKEY_DEEPSEEK_MODEL", "deepseek-flash"),
    messages=[
        {
            "role": "user",
            "content": "Retournez une phrase confirmant que la route DeepSeek est active.",
        }
    ],
    stream=False,
)

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

Après la requête, ouvrez les journaux d’utilisation Flatkey et vérifiez le nom du modèle, les décomptes de jetons, la latence, le coût, la clé, l’horodatage et l’état d’erreur. Si le journal ne correspond pas à la requête que vous avez envoyée, la migration n’est pas terminée.

Matrice de tests avant la bascule

Erreurs courantes

• Traiter la migration DeepSeek V4 comme un simple remplacement de texte sans vérifier la documentation DeepSeek actuelle.
• Remplacer deepseek-v4-flash-vision-exp par deepseek-flash sans jamais tester l’entrée d’image.
• Supposer que deepseek-v4-pro a été arrêté après le 14 septembre 2026 alors que la documentation actuelle indique que le service continue.
• Mettre à jour le code de l’application tout en laissant des alias obsolètes dans les tâches d’évaluation, les notebooks, les extraits clients ou les politiques de repli.
• Comparer uniquement les prix des jetons en valeur nominale au lieu du coût par réponse acceptée.
• Supposer que le comportement direct de DeepSeek et le comportement acheminé via Flatkey sont identiques sans vérifier l’itinéraire et les journaux en direct.
• Laisser des paramètres non pris en charge de l’API Responses modifier silencieusement le comportement du produit.

Liens internes pour l’étape suivante

Si vous êtes encore en train de choisir des routes DeepSeek, associez cette liste de vérification à DeepSeek V4 Pro vs Flash et à DeepSeek vs Qwen API routing checks. Si le projet plus vaste concerne la standardisation du gateway, lisez le guide de démarrage rapide de Flatkey API, le guide du catalogue de modèles d’IA et les métriques des API de routage IA. Pour les décisions de fournisseurs sensibles à la région, utilisez le routage régional des fournisseurs de LLM.

FAQ

Quel est le nom actuel du modèle DeepSeek Flash ?

Le nom actuel du modèle Flash dans la documentation DeepSeek est deepseek-flash. Une migration DeepSeek V4 sûre devrait faire migrer les alias Flash obsolètes vers cette chaîne de modèle après les tests de routage.

deepseek-v4-flash et deepseek-v4-flash-vision-exp sont-ils cassés ?

DeepSeek indique que ces anciens noms sont toujours acceptés, mais leurs modèles correspondants ont été retirés et les requêtes sont servies par DeepSeek-V4.1-Flash. Cette compatibilité est utile pendant la migration, mais le nouveau code ne devrait pas s’appuyer sur des alias retirés.

deepseek-v4-pro a-t-il cessé de fonctionner après le 14 septembre 2026 ?

Non. La documentation actuelle de DeepSeek indique que le service API pour deepseek-v4-pro continue après le 14 septembre 2026, avec la méthode de facturation inchangée, sauf nouvelle notification de DeepSeek. Gardez-le explicite et surveillé si vous l’utilisez.

Dois-je changer l’URL de base DeepSeek ?

Pas pour un appel DeepSeek direct au format OpenAI. DeepSeek documente https://api.deepseek.com comme URL de base au format OpenAI. Pour Flatkey, utilisez https://router.flatkey.ai/v1 avec une clé API Flatkey.

Flatkey remplace-t-il les tests de routage spécifiques aux fournisseurs ?

Non. Flatkey peut centraliser la clé, l’URL de base, le catalogue et la revue de l’utilisation, mais votre équipe doit toujours vérifier la ligne exacte du modèle, le comportement des fonctionnalités, les champs de coût, l’état du routage et le plan de repli.

Toutes les charges de travail doivent-elles passer à deepseek-flash ?

Non. deepseek-flash est la cible Flash actuelle, mais les charges de travail qui utilisent intentionnellement deepseek-v4-pro doivent être testées et suivies séparément. Choisissez par charge de travail, pas selon une règle globale de remplacement.

Conseils finaux de déploiement

Liste de vérification de migration DeepSeek V4 : remplacez les alias obsolètes en toute sécurité doit se terminer par des preuves, et pas seulement par un diff fusionné. Remplacez les alias Flash retirés, gardez les routes Pro intentionnelles, testez les fonctionnalités que votre produit utilise réellement et vérifiez la requête dans les journaux. Puis consultez le répertoire actuel des modèles Flatkey et la page tarification Flatkey avant de déplacer le trafic de production.