DeepSeek V4.1 Flash API 요금·구매처·연결 방법

DeepSeek V4.1 Flash를 직접 호출하려면 https://api.deepseek.com에서 deepseek-flash를 사용합니다. 크레딧 구매 전 공급자와 프로토콜을 고르고 작업 비용을 계산한 뒤 같은 공급자가 발급한 키를 설정하세요. 이 가이드는 구매 결정부터 첫 요청까지 이 순서대로 설명합니다.

2026년 9월 11일 DeepSeek 공식 문서와 대조했습니다. 코드의 문서 대조와 문법 검사는 완료했지만 유료 전체 경로 테스트는 수행하지 않았습니다. 모델 선택은 DeepSeek, Gemini, Qwen 비교를 참고하세요.

1. API를 이용할 곳 고르기

공식 출시 이력에서 직접 API 제공을 확인할 수 있습니다. 타사 항목은 별도 검증이 필요합니다. DeepSeek의 기존 이름 라우팅이 게이트웨이의 모델 매핑을 입증하지는 않습니다.

Ofox 결과는 검증 범위의 한계이지 미제공의 증거가 아닙니다. 공급자는 표시 이름과 별개로 라우팅을 바꿀 수 있으며, 블로그 발표만으로 구매 가능한 경로가 입증되지도 않습니다. 텍스트 대화, Codex Responses, Claude Code 도구와 이미지 입력은 필요한 작업별로 호환성을 확인하세요.

Ofox에서는 모델 목록과 인증 문서를 확인하세요. 확인된 경로가 요구 사항에 맞으면 계정을 만들고 API 키를 준비합니다. 게이트웨이 계정에 충전해도 공식 DeepSeek 계정 잔액은 늘어나지 않습니다.

2. 크레딧 구매 전에 비용 계산하기

아래는 공식 요금 페이지에서 확인한 DeepSeek 직접 API의 100만 토큰당 미국 달러 가격입니다. Ofox 견적이 아닙니다.

피크 시간대는 월요일부터 금요일까지 UTC 01:00–04:00 및 06:00–10:00이며 그 외는 비피크입니다. 베이징 시간으로 09:00–12:00 및 14:00–18:00, 서울·도쿄 시간으로 10:00–13:00 및 15:00–19:00입니다. 서머타임이 있는 지역은 날짜와 시간대를 고려해 변환하세요. 요청이 요금 변경 시각에 걸치면 임의의 분할 과금 공식을 만들지 말고 실제 과금 규칙을 확인해야 합니다.

같은 프롬프트를 반복해도 입력 전체가 캐시로 과금됐다는 뜻은 아닙니다. 응답 사용량과 과금 기록을 확인하세요. 캐시 적중과 미적중이 섞인 입력은 아래 식으로 계산합니다.

Cost = cached_input_tokens / 1_000_000 × cached_input_rate
     + uncached_input_tokens / 1_000_000 × uncached_input_rate
     + billed_output_tokens / 1_000_000 × output_rate

예를 들어 요청 100회에 매회 미적중 입력 10,000토큰과 과금 대상 출력 2,000토큰을 사용하면 합계는 입력 100만, 출력 20만 토큰입니다.

Off-peak: (1 × $0.15) + (0.2 × $0.60) = $0.27
Peak:     (1 × $0.30) + (0.2 × $1.20) = $0.54

이 예산은 공급자별 추가 요금을 제외하면 5달러로 비피크에 100회 묶음 18개, 피크에는 9개를 실행할 수 있습니다. 유용한 작업 1,800건을 보장하는 것은 아닙니다. 에이전트는 여러 번 호출하고 재시도하며 기록을 누적하고, 최종 답변에 보이는 길이보다 많은 출력을 소비할 수 있습니다.

판매자를 비교할 때는 공식 단가를 해당 공급자의 견적으로 바꾸세요. 최소 결제액, 구매 수수료, 요금 시간대와 환불 조건을 확인합니다. 잔액을 늘리기 전에 대표 작업 하나를 완료하는 예산을 잡으세요.

3. 계정·키·모델 맞추기

호출할 공급자에게서 키를 발급받으세요. DeepSeek Platform의 직접 연결 키는 DeepSeek 엔드포인트와, Ofox 키는 문서에 명시된 Ofox 경로와 함께 사용합니다. 직접 연결 인증 정보를 로컬 DEEPSEEK_API_KEY에 저장하고 커밋하거나 출력하지 마세요.

정확한 모델 ID를 사용하세요. 공식 deepseek-flash는 현재 V4.1 Flash를 선택합니다. 기존 Flash 이름은 호환용 별칭이며 expires-on-0910 베타 설정은 이전 출시 단계에 해당합니다. 이름의 의미는 출시 안내에서 설명합니다. 기존 Pro 사용자는 9월 14일 전환 체크리스트도 확인하세요.

4. Python이나 curl로 작은 요청 보내기

공식 시작 가이드에 따라 프로젝트 환경에서 python -m pip install openai로 호환 Python 클라이언트를 설치한 뒤 실행합니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Reply with one short greeting."}],
    max_tokens=128,
    extra_body={"thinking": {"type": "disabled"}},
)
print(response.choices[0].message.content)
print(response.usage)

진단 작업을 작게 유지하기 위해 처음에는 사고 모드와 도구를 사용하지 않습니다. 기본 호출이 성공하면 필요한 기능을 하나씩 추가하고 문서의 파라미터를 확인하세요.

동일한 curl 요청은 다음과 같습니다.

curl --fail-with-body https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with one short greeting."}],"max_tokens":128,"thinking":{"type":"disabled"}}'

실패하면 민감한 정보를 제거한 오류 본문을 보관하세요. 인증 헤더를 포함한 상세 로그는 공유하지 마세요. JavaScript의 OpenAI SDK 옵션은 baseURL이며 모델과 JSON 필드는 같습니다. Python 인수 이름을 기계적으로 복사하지 말고 설치된 SDK의 인터페이스를 따르세요.

5. 클라이언트에 필요한 프로토콜 설정하기

클라이언트 설정은 Codex 가이드나 Claude Code 가이드를 사용하세요. 텍스트 응답만으로 도구 호출 반복, 이미지 입력이나 스트리밍 파서를 검증할 수 없습니다. 주 모델 선택만으로 모든 보조 작업이 어떤 모델을 쓰는지도 확인되지 않습니다.

6. 충전 전에 오류 원인 확인하기

모델이 없으면 목적지와 정확한 식별자를 먼저 확인하세요. 오래된 클라이언트 목록에는 deepseek-flash가 없을 수 있고 게이트웨이는 다른 ID를 사용할 수 있습니다. 모든 공급자가 같은 미등록 모델 오류를 반환한다고 가정하지 마세요.

공식 오류 문서는 401 인증, 402 잔액 부족, 400 요청 형식, 422 파라미터와 429 속도 제한을 구분합니다. 충전은 확인된 잔액 문제에 대응하며 다른 유형의 오류를 고치지 않습니다. 일시적 실패는 간격을 두고 횟수를 제한해 재시도하세요.

대표 작업이 성공하면 비밀 정보 없이 모델, 공급자, 시각, 토큰 사용량과 청구액을 기록합니다. 청구액을 예산과 비교하고 결과가 유용한지도 확인하세요. 필요한 작업과 비용을 실제 경로에서 검증한 후 충전 금액을 늘리세요.