DeepSeek 시리즈

DeepSeek의 V4 시리즈 모델로 V4.1 Flash, V4 Pro, V4 Flash가 있습니다. OpenAI 호환 API로 호출하며 Anthropic 네이티브 API도 지원하므로 Claude Code 등의 도구에서 바로 사용할 수 있습니다.

주요 작업

모델

V4 시리즈의 컨텍스트는 1M 토큰이며 최대 출력은 384K 토큰입니다. V4.1 Flash는 이미지 입력을 지원하고, 나머지 모델은 텍스트만 지원합니다. 전체 모델 목록과 실시간 가격은 모델 페이지 를 참고하십시오.

별칭과 버전

• 별칭은 deepseek/ 접두사 없이 사용해야 합니다. 예: "model": "deepseek-v4-pro". deepseek/deepseek-v4-pro로 쓰면 404가 반환됩니다.
• DeepSeek 공식 API의 deepseek-chat, deepseek-reasoner는 OfoxAI에서 사용할 수 없습니다. 위 표의 모델 ID를 사용하십시오.
• 이전 버전인 deepseek/deepseek-v4-pro-0423, deepseek/deepseek-v4-flash-0423도 계속 호출할 수 있지만, 사고를 켜는 방법이 새 버전과 다릅니다. 사고 모드를 참고하십시오.

호출 예시

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
    "thinking": {"type": "disabled"}
  }'

사고 모드

실측 결과 같은 수학 문제에서 V4 Pro는 기본 설정으로 약 1만 2천 토큰을 사고하며 약 2분이 걸렸고, 사고를 끄면 약 20초가 걸렸습니다. 사고 토큰은 출력 단가로 과금되며, 수량은 usage.completion_tokens_details.reasoning_tokens에서 확인할 수 있습니다.

사고 내용 읽기

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "17 × 23은 얼마입니까?"}],
)
msg = resp.choices[0].message
details = getattr(msg, "reasoning_details", None) or []
print("[사고]", "".join(d.get("text", "") for d in details))
print("[답변]", msg.content)

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "17 × 23은 얼마입니까?"}],
    stream=True,
)
for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)

• 비스트리밍 응답에서는 사고 내용이 message.reasoning_details에 있으며, 각 항목의 text를 순서대로 이어 붙이십시오.
• 스트리밍 응답에서는 사고 내용이 delta.reasoning_content에 있으며, DeepSeek 공식 API와 같습니다.
• 멀티턴 대화에서 이전 메시지에 사고 내용을 다시 전달할 필요는 없습니다.

Claude Code에서 사용

DeepSeek V4 시리즈는 Anthropic 네이티브 API를 지원하며, 주소는 https://api.ofox.ai/anthropic입니다. Claude Code 등 Anthropic 프로토콜 기반 도구에서 사용할 수 있습니다.

curl https://api.ofox.ai/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "max_tokens": 4000,
    "thinking": {"type": "disabled"},
    "messages": [{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}]
  }'

• Anthropic API로 호출하면 사고 내용이 thinking 블록으로 반환되며, "thinking": {"type": "disabled"}로 사고를 끌 수도 있습니다.
• 사고를 켤 때는 max_tokens를 충분히 크게 설정하십시오. 한도가 부족하면 응답에 답변 없이 thinking 블록만 있을 수 있습니다.

Claude Code의 전체 설정 방법은 Claude Code 설정을 참고하십시오.

JSON 출력과 도구 호출

response_format은 {"type": "json_object"}와 {"type": "json_schema", ...}를 지원하며, 도구 호출에는 표준 tools 파라미터를 사용합니다.

import json
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro-0813",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "price와 currency를 JSON으로 반환해 주세요. 라켓과 공을 합쳐 1.10달러이고, 라켓이 공보다 1달러 비쌉니다. 공은 얼마입니까?"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(json.loads(resp.choices[0].message.content))

json_object를 사용할 때는 프롬프트에 「JSON으로 반환」과 필요한 필드를 명시하십시오.

프롬프트 캐싱

DeepSeek는 반복되는 요청 접두부를 자동으로 캐시하므로 요청을 수정할 필요가 없습니다. 적중량은 usage.prompt_tokens_details.cached_tokens에서 확인할 수 있으며, 적중한 부분은 캐시 읽기 단가로 과금됩니다. 캐시는 최선형(best effort)이므로 접두부가 같은 요청도 적중하지 않을 수 있습니다.

공급자

공급자를 지정하는 방법은 공급자 라우팅을 참고하십시오.

자주 발생하는 오류

기타 일반 오류는 오류 처리를 참고하십시오.

공식 문서

• DeepSeek API 문서 
• DeepSeek · 사고 모드 
• DeepSeek · Anthropic API 호환 

공식 문서는 DeepSeek에 직접 연결할 때의 동작을 설명합니다. OfoxAI에서 호출할 때는 모델 ID와 엔드포인트 주소를 이 페이지 기준으로 사용하십시오.

자주 묻는 질문