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

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 évaluez Vision Exp séparément.

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 768 tokens image comme plafond upstream prudent, 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 expérimental en configuration. 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 ?

Oui. Au 21 août 2026, EvoLink le documente avec compréhension d’image sur Chat Completions, Messages et Responses.

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

Non. La route texte peut ignorer l’image réelle. Utilisez Vision Exp ou un autre modèle Vision validé dès que la réponse dépend des pixels.

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 ?

Jusqu’à 384 tokens d’entrée selon DeepSeek, auxquels s’ajoutent texte, sortie, retries et tours agent. Appliquez ensuite 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 l’ID, les champs image ou les limites changent.