DeepSeek의 API는 두 개의 엔드포인트와 두 개의 모델 이름으로 구성됩니다 — 각각 무엇을 받는지 알아보겠습니다

DeepSeek API는 실제보다 더 단순해 보인다. 두 개의 기본 URL, 두 개의 모델 식별자, 그리고 두 열이 거의 동일한 기능 매트릭스가 있다 — 단 하나의 행만 빼고, 그 행이 워크로드가 애초에 가능한지 자체를 결정한다. OpenAI SDK에서 이전 중이라면 둘 중 하나가 필요하고, Anthropic 형태의 하네스에서 이전 중이라면 나머지 하나가 필요하다. 그리고 스크린샷을 보내는 경우라면 두 모델 중 하나만 이를 받아들인다.

두 기지

• OpenAI 형식 — code>https://api.deepseek.com/code>. OpenAI 형태의 채팅 완성, Responses API, JSON 출력, 도구 호출, 그리고 베타로 제공되는 접두사 완성을 포함합니다.

• Anthropic 형식 — code>https://api.deepseek.com/anthropic/code>. 동일한 두 모델을 Anthropic 형태의 표면 뒤에 제공하며, 이는 해당 프로토콜을 사용하는 코딩 하네스에 필요한 것입니다.

두 베이스 모두 두 모델을 지원합니다. 베이스 선택은 기능이 아니라 클라이언트 라이브러리에 관한 것입니다.

두 이름, 그리고 각 이름 뒤에 있는 것

• deepseek-flash — 현재 DeepSeek-V4.1-Flash-1017(10월 체크포인트)이 제공 중입니다. 멀티모달: 텍스트 및 이미지 입력, 텍스트 출력. 1M 컨텍스트, 최대 출력 384K, 동시 요청 2,500건.

• deepseek-v4-pro —DeepSeek-V4-Pro-0813에서 제공됩니다. 텍스트 전용입니다. 동일한 1M 컨텍스트와 384K 출력, 동시 요청 500개.

두 개의 레거시 식별자는 여전히 허용됩니다 — code>deepseek-v4-flash/code> 및 code>deepseek-v4-flash-vision-exp/code> — 하지만 DeepSeek의 문서에는 해당 모델이 지원 종료되었고, 요청이 V4.1-Flash-1017에서 처리되며, Flash 가격으로 청구된다는 점이 명확히 나와 있습니다. 실제로 이는 기존 통합이 계속 작동하면서 조용히 다른 모델의 응답을 반환하기 시작한다는 뜻이며, 출력 변화를 다른 무엇 때문으로 돌리기 전에 확인해 볼 가치가 있습니다.

기능 매트릭스, 행별로

거의 모든 것이 공유됩니다. 예외가 바로 이 가이드가 존재하는 이유입니다.

• 사고 모드 —두 모델 모두 비사고 모드와 사고 모드를 지원하며, 사고 모드가 기본값입니다. 노력 수준은 low, high, max이며, DeepSeek의 지침은 간단한 작업에는 low, 일상적인 에이전트 작업에는 high, 더 어려운 시나리오에는 max입니다.

• JSON 출력, 도구 호출, 접두사 완성 — 둘 모두에서 동일하게 지원됩니다. 접두사 완성은 베타 버전입니다.

• Responses API와 Anthropic API — 두 모델 모두에서 둘 다 지원되는데, 이는 흔치 않은 일이라 알아두면 좋습니다. 번역 계층 없이 어느 클라이언트 형태로든 두 모델을 구동할 수 있습니다.

• FIM 완성 —둘 다 베타이며, 둘 다 비사고 모드에서만 제공됩니다. 사용 사례가 코드 인필이라면, 그 제한은 플래그십에도 적용됩니다.

• 비전 —체크 표시: code>deepseek-flash/code>, "지원되지 않음": code>deepseek-v4-pro/code>. 이것은 매트릭스의 유일한 분기점이며, 프롬프트 변경으로 우회할 수 있는 사항이 아닙니다.

식별자들이 비용에 대해 암시하는 것

모델 이름에 가격 체계가 반영되어 있습니다. Flash는 백만 토큰당 입력 $0.15, 출력 $0.60이며, 캐시 적중 시 $0.003입니다. V4 Pro는 입력 $0.66, 출력 $1.98이며, 캐시 적중 시 $0.022입니다. 둘 다 UTC 기준 월요일부터 금요일까지 01:00–04:00 및 06:00–10:00 동안 두 배가 됩니다. 따라서 선택하는 모델 이름이 기능과 청구 금액을 모두 결정하며, 위의 레거시 이름은 어느 체크포인트가 응답하든 청구 금액을 Flash 요율로 설정합니다.

한 가지 실질적인 결과: code>deepseek-flash/code>가 이제 10월에 공개된 체크포인트를 가리키므로, 9월 모델을 기준으로 작성된 비용 모델이나 품질 기준선은 해당 식별자로 더 이상 받지 못하는 내용을 설명하게 됩니다. 이번 달에 다시 측정하지 않은 이름에는 아무것도 고정하지 마세요.

라우팅 계층과 비교하면 어떤가요?

DeepSeek 자체 표면은 두 개의 프로토콜 뒤에 두 개의 모델을 갖추고 있습니다. 애플리케이션이 항상 가장 강력한 DeepSeek 모델만 필요로 한다면, 그걸로 충분합니다. 충분하지 않은 경우는 이 형태로 표현할 수 없는 경우들입니다: 공급자 장애에 대비해 대체 모델을 선택하는 것, 하나의 워크플로에서 DeepSeek를 다른 벤더의 모델과 조합하는 것, 또는 두 개의 통합 없이 실제 트래픽에서 Flash와 Pro를 A/B 테스트하는 것입니다.

그것이 바로 OrcaRouter의 224개 모델, OpenAI 호환 엔드포인트가 존재하는 이유이며, DeepSeek V4 Pro와 V4.1 Flash 모두 DeepSeek이 공개한 요율로 마크업 없이 여기에 올라가 있습니다. 캐시 적중 행과 피크 시간 두 배 적용까지 포함되는데, 벤더의 가격이 그대로 전달되기 때문입니다. 위의 엔드포인트는 DeepSeek이 문서화한 방식 그대로 여전히 작동합니다. 라우터는 벤더의 API를 대체하는 것이 아니라, 여러 API 사이를 전환할 수 있는 한 지점을 제공하는 것입니다.

마이그레이션 체크리스트, 순서대로

• 원하는 모델이 아니라 클라이언트 형태에 따라 베이스를 선택하세요.

• 보내는 내용에 따라 모델을 고르세요: 이미지라면 Flash, 텍스트만 하는 작업이라면 가격이 결정합니다.

• 기본값을 상속하는 대신 사고 노력을 명시적으로 설정하세요. 기본값은 사고가 켜져 있기 때문입니다.

• 이전 식별자가 귀하 모르게 사용 중지되었는지 확인하십시오 — 두 레거시 이름은 허용되고, 재청구되며, 재제공됩니다.

• 월별 청구 금액을 추정하기 전에 캐시 적중 비율을 측정하세요. 안정적인 접두사는 30× 할인이고, 불안정한 접두사는 아무것도 아니기 때문입니다.