Utiliser l’API DeepSeek V4 Flash Vision Exp avec des images

Mise à jour du cycle de vie — 10 septembre 2026 : DeepSeek a publié V4.1 Flash. Sur l’API directe de DeepSeek, deepseek-v4-flash et deepseek-v4-flash-vision-exp renvoient désormais vers V4.1 Flash, et deepseek-v4-pro doit suivre le 14 septembre 2026 à 12 h 00, heure de Pékin (04 h 00 UTC). Sur EvoLink, deepseek-v4-flash et deepseek-v4-pro ne sont pas concernés et continuent de servir DeepSeek V4 Flash et V4 Pro ; deepseek-v4-flash-vision-exp redirige désormais vers DeepSeek V4.1 Flash. Voir la mise à jour officielle, la page du modèle V4.1 Flash et le guide de migration.

Réponse rapide : prérequis du premier appel image

Si un contrôle d’exécution échoue, gardez ce workload sur un modèle Vision déjà validé et traitez V4.1 Flash comme un candidat à évaluer.

Comprendre le workflow d’entrée image

Le flux pratique consiste à joindre une ou plusieurs images à une instruction précise, sélectionner le protocole, valider le résultat structuré et enregistrer l’usage avant d’élargir le routage. Un navigateur ou un agent ne doit jamais exécuter une action irréversible sur la seule base d’une réponse visuelle non vérifiée.

Préparez un petit jeu d’évaluation : capture nette, interface dense, page numérisée, graphique à petites étiquettes et image volontairement ambiguë. Définissez les champs ou la décision attendue avant l’appel.

Choisir la structure du protocole

Ces exemples correspondent aux formes EvoLink actuelles. Utilisez l’endpoint, les champs obligatoires et les limites de la page du protocole choisi.

Chat Completions : image_url

{
  "model": "deepseek-v4-flash-vision-exp",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "Return the visible error message and the UI state as JSON." },
      { "type": "image_url", "image_url": { "url": "https://example.com/screenshot.png" } }
    ]
  }]
}

Messages : bloc image

{
  "model": "deepseek-v4-flash-vision-exp",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      { "type": "image", "source": { "type": "url", "url": "https://example.com/invoice.png" } },
      { "type": "text", "text": "Extract invoice number, date, currency, subtotal, tax, and total." }
    ]
  }]
}

Responses : input_image

Responses convient aux workflows agentiques plus longs :

{
  "model": "deepseek-v4-flash-vision-exp",
  "input": [{
    "role": "user",
    "content": [
      { "type": "input_text", "text": "Summarize the chart, then list every directly observed label." },
      { "type": "input_image", "image_url": "https://example.com/chart.png" }
    ]
  }]
}

URL, Base64 ou Files API ?

Préférez une URL signée pour les gros fichiers accessibles au gateway et Base64 pour les petites images privées. N’affirmez pas la disponibilité de Files API sans documentation EvoLink dédiée. DeepSeek documente JPEG, PNG, GIF et WebP upstream ; les limites de taille, URL, délai et nombre d’images peuvent être plus strictes sur le gateway.

Estimer le coût sans dupliquer les tarifs

Pour deux images, utilisez 2048 tokens image comme plafond prudent selon la règle actuelle de l’API directe, puis ajoutez prompt et sortie. Comparez ensuite avec l’usage réel EvoLink. Ne supposez pas que le cache des préfixes texte s’applique de la même manière aux images.

Valider avant d’automatiser

Mesurez le taux de résultats acceptés, pas seulement les réponses HTTP réussies. Retries et corrections humaines peuvent rendre une route apparemment moins chère plus coûteuse.

Erreurs fréquentes

N’inventez pas de limite RPM, TPM, taille ou concurrence. Utilisez les limites de la route et vérifiez le comportement avec le compte qui portera le trafic.

Déploiement progressif

1. Réussir une requête URL ou Base64 sur le protocole choisi.
2. Contrôler réponse, usage, facturation et logs d’erreur.
3. Comparer le jeu d’évaluation fixe à un fallback.
4. Router une petite part et mesurer le coût par résultat accepté.
5. Élargir seulement si qualité, latence, erreurs et coût respectent les seuils.

Gardez l’ID de modèle en configuration plutôt qu’en dur. Le gateway unifié EvoLink permet de comparer routes, usage et facturation sans reconstruire l’intégration autour d’un seul modèle provider.

FAQ

Quel est l’ID exact du modèle ?

Vision Exp est-il disponible sur EvoLink ?

Puis-je envoyer une image à deepseek-v4-flash ?

URL ou Base64 ?

URL signée pour un asset plus grand accessible au gateway ; Base64 pour une petite image privée dans la limite documentée. Protégez les données dans les deux cas.

Files API est-il pris en charge ?

DeepSeek le documente upstream, mais cela ne prouve pas son exposition sur chaque route EvoLink. Attendez une confirmation explicite de la route.

Combien coûte une image ?

Pour le modèle Vision Exp d’origine, DeepSeek indiquait jusqu’à 384 tokens d’entrée par image ; son guide Vision actuel fixe un plafond de 1024 tokens par image sur l’API directe. Les requêtes vers cet ID tournent désormais sur V4.1 Flash : planifiez avec la règle actuelle, ajoutez texte, sortie, retries et tours agent, puis appliquez les tarifs en direct de la page produit.

Quels formats d’image ?

JPEG, PNG, GIF et WebP sont documentés upstream. Vérifiez aussi les limites EvoLink de taille, URL et multi-image.

Que tester avant la production ?

Images simples et difficiles, sortie structurée, petit texte, champs absents, latence, retries, usage, facturation et fallback.

Sources et prochaines étapes

• EvoLink Chat Completions
• EvoLink Messages
• EvoLink Responses
• Guide Vision DeepSeek
• Annonce Vision Exp
• Journal des changements DeepSeek

Synchronisez ce guide avec les trois pages EvoLink et retestez exemples et facturation si le modèle derrière cet ID, les champs image ou les limites changent.