DeepSeek V4 Flash Vision Exp API 사용법: 이미지 입력

라이프사이클 업데이트(2026년 9월 10일): DeepSeek이 V4.1 Flash를 출시했습니다. DeepSeek 직결 API에서는 deepseek-v4-flash와 deepseek-v4-flash-vision-exp가 이미 V4.1 Flash로 라우팅되며, deepseek-v4-pro도 2026년 9월 14일 베이징 시간 12:00(한국 시간 13:00, UTC 04:00)부터 뒤따를 예정입니다. EvoLink에서는 deepseek-v4-flash와 deepseek-v4-pro가 영향을 받지 않으며 계속 DeepSeek V4 Flash와 V4 Pro를 제공합니다. deepseek-v4-flash-vision-exp는 이제 DeepSeek V4.1 Flash로 리디렉션됩니다. 자세한 내용은 공식 업데이트, V4.1 Flash 모델 페이지, 마이그레이션 가이드를 참고하세요.

첫 이미지 호출 전 확인 사항

Runtime 확인이 실패한 Workload는 검증된 Vision 모델에 유지하고 V4.1 Flash를 평가 대상으로 둡니다.

이미지 입력 Workflow

한 장 이상의 이미지와 구체적인 지시를 보내고 Protocol을 선택한 뒤 구조화 결과와 Usage를 검증하고 Traffic을 늘립니다. 검토하지 않은 한 번의 시각 답변만으로 Browser나 Agent가 되돌릴 수 없는 Action을 실행하면 안 됩니다.

깨끗한 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 Block

{
  "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 지원을 주장하지 않습니다. Upstream은 JPEG, PNG, GIF, WebP를 문서화하지만 Gateway의 Size, URL, Timeout, 이미지 수 Limit은 별도 확인합니다.

이미지 Cost 계산

자동화 전 검증

HTTP 성공률이 아니라 승인 결과율을 측정하세요. Retry와 수동 수정이 많으면 저렴한 Route가 더 비쌀 수 있습니다.

자주 발생하는 오류

RPM, TPM, File Size, Concurrency를 추정하지 말고 Route 문서와 Production Account로 검증하세요.

Production Rollout

1. 선택 Protocol에서 URL/Base64 한 건 성공.
2. Response, Usage, Billing, Error Log 확인.
3. 고정 평가 Set으로 후보 모델(V4.1 Flash)과 Fallback 비교.
4. 소량 Traffic에서 승인 결과 Cost 측정.
5. 품질, Latency, Error, Cost가 기준을 충족하면 확대.

Model ID는 Config에서 관리하세요. EvoLink 통합 Gateway는 한 모델을 위해 Integration을 다시 만들지 않고 Route, Usage, Billing을 비교하게 합니다.

FAQ

정확한 Model ID는 무엇인가요?

EvoLink에서 사용할 수 있나요?

deepseek-v4-flash에 이미지를 보낼 수 있나요?

URL과 Base64 중 무엇을 쓰나요?

큰 접근 가능 Asset은 Signed URL, 작은 Private 이미지는 Limit 내 Base64를 사용합니다.

Files API를 지원하나요?

Upstream 문서만으로 EvoLink 각 Route 지원을 증명할 수 없습니다. EvoLink가 명시한 경우만 사용합니다.

이미지 한 장 Cost는?

원래 Vision Exp 모델은 이미지당 최대 384 Input Token이었고, 현재 Vision 가이드는 직결 API에서 이미지당 최대 1024 Token을 상한으로 둡니다. 이 ID의 Request는 이제 V4.1 Flash에서 실행되므로 현재 규칙으로 계획하고 Text, Output, Retry, Agent Turn을 더한 뒤 제품 페이지 Rate를 적용합니다.

이미지 Format은?

Upstream은 JPEG, PNG, GIF, WebP입니다. EvoLink Size, URL, 다중 이미지 Limit도 확인하세요.

Production 전에 무엇을 Test하나요?

쉬운/어려운 이미지, 구조화 출력, 작은 글자, 누락 Field, Latency, Retry, Usage, Billing, Fallback입니다.

출처

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

이 ID 뒤의 모델, 이미지 Field, Route Limit이 바뀌면 예제와 Billing을 다시 검증하세요.