DeepSeek V4 Flash Vision Exp APIの使い方：画像入力ガイド

最初の画像リクエスト前に必要な確認

Runtime確認に失敗したWorkloadは検証済みVisionモデルに残し、Vision Expを評価候補として扱います。

画像入力ワークフロー

1枚以上の画像と具体的な指示を送り、Protocolを選択し、構造化結果とUsageを検証してからTrafficを増やします。未レビューの1回答だけでBrowserやAgentに不可逆操作をさせないでください。

きれいなScreenshot、密なUI、Scan文書、小さいLabelのChart、意図的に曖昧な画像を含む小さな評価Setを作り、期待Fieldや判断を先に定義します。

Protocol別の画像形式

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：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

{
  "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・Files APIの選び方

大きい画像は取得可能なSigned URL、小さいPrivate画像はBase64が適します。EvoLink文書がないFiles API対応は主張しません。DeepSeek UpstreamはJPEG、PNG、GIF、WebPを記載していますが、GatewayのSize、URL、Timeout、枚数Limitは別途確認します。

画像Costの見積もり

自動化前の受入基準

HTTP成功率ではなく合格結果率を測定します。Retryや人手修正が多い安価なRouteは、強いFallbackより高くなる場合があります。

よくある画像Request Error

RPM、TPM、File Size、Concurrencyを推測せず、Route文書と本番Accountで確認します。

本番Rollout

1. 選択ProtocolでURL/Base64を1件成功させる。
2. Response、Usage、Billing、Error Logを確認。
3. 固定評価SetでVision ExpとFallbackを比較。
4. 少量Trafficで合格結果Costを測定。
5. 品質、Latency、Error、CostがThresholdを満たしてから拡大。

Model IDはConfigで管理します。EvoLinkの統合Gatewayなら、実験モデル専用にIntegrationを書き直さず、Route・Usage・Billingを比較できます。

FAQ

正確なModel IDは？

EvoLinkで利用できますか？

はい。2026年8月21日時点でChat Completions、Messages、Responsesの画像理解が文書化されています。

deepseek-v4-flashへ画像を送れますか？

画像証拠は処理されない可能性があります。画像依存TaskではVision Expか検証済みVisionモデルを使います。

URLとBase64のどちら？

大きく取得可能なAssetはSigned URL、小さいPrivate画像はLimit内でBase64を使います。

Files APIは使えますか？

Upstreamの記載だけではEvoLink各Routeの対応を証明できません。EvoLink文書で明示された場合のみ使います。

1画像のCostは？

DeepSeekは最大384 Input Tokenとしています。Text、Output、Retry、Agent Turnを加え、製品ページのLive Rateを適用します。

対応Formatは？

UpstreamはJPEG、PNG、GIF、WebPです。EvoLink固有のSize、URL、複数画像Limitも確認します。

本番前に何をTestする？

簡単/難しい画像、構造化出力、小文字、欠落Field、Latency、Retry、Usage、Billing、Fallbackです。

参照資料

• EvoLink Chat
• EvoLink Messages
• EvoLink Responses
• DeepSeek Vision Guide
• Vision Exp Release
• DeepSeek Changelog

Model ID、画像Field、Route Limitが変わったら、例とBillingを再検証します。