DeepSeek Files API (2026): 제한 사항, 업로드 및 file_id 실전 활용

한눈에 보는 제한 사항

출처: 공식 Files API 가이드, 2026-08-21 확인.

한 번 업로드하고 계속 참조 (최대 30일)

스크린샷을 업로드하고 file_id 받기:

curl https://api.deepseek.com/files \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -F "purpose=user_data" \
  -F "file=@dashboard.png"

그런 다음 vision-exp 채팅에서 참조 — base64 데이터 불필요, 후속 턴에서 재업로드 불필요:

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash-vision-exp",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "Which metric regressed in this dashboard?"},
        {"type": "file", "file_id": "file-api-xxxx"}
      ]
    }]
  }'

OpenAI SDK를 사용하는 Python — 업로드 후 채팅:

from openai import OpenAI

client = OpenAI(api_key="YOUR_KEY", base_url="https://api.deepseek.com")

f = client.files.create(file=open("dashboard.png", "rb"), purpose="user_data")

resp = client.chat.completions.create(
    model="deepseek-v4-flash-vision-exp",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Which metric regressed?"},
            {"type": "file", "file_id": f.id},
        ],
    }],
)
print(resp.choices[0].message.content)

• 인라인 대안: 파일 블록은 file_id 대신 file_data(base64)를 포함할 수 있습니다 — 상호 배타적 필드; filename은 file_data와 함께만 사용할 수 있습니다.
• Anthropic 스타일 스택: anthropic-beta: files-api-2025-04-14 헤더를 사용하면 /messages에서도 동일한 파일 블록이 작동합니다.

파일 vs base64 vs URL 사용 시점

FAQ

관련 항목