DeepSeek V4.1 Flash API 사용법: 모델 ID와 Python·curl 설정

DeepSeek V4.1 Flash API를 직접 호출할 때는 model="deepseek-flash"와 베이스 URL https://api.deepseek.com을 사용합니다. 공개 제품명과 요청에 넣는 식별자는 서로 다른 문자열입니다. 타사 게이트웨이는 자체 모델 식별자와 인증 정보를 사용할 수 있습니다.

예시는 공식 시작 가이드와 2026년 9월 10일 출시 이력을 따릅니다. 문서와 대조한 설정 예시이며 유료 전체 경로 테스트를 수행한 것은 아닙니다. 생성 요청을 실행하면 크레딧이 사용될 수 있습니다.

계정과 모델부터 확인하세요

실제로 호출할 공급자에서 인증 정보를 발급받으세요. 공식 DeepSeek 키는 DeepSeek 엔드포인트와, Ofox 키는 Ofox 문서에 명시된 경로와 함께 사용해야 합니다. 서로 다른 공급자의 키와 엔드포인트를 조합하지 마세요.

아래 예시에서는 로컬 환경 변수 DEEPSEEK_API_KEY에 인증 정보를 저장합니다. 저장소에 커밋하거나 로그로 출력하지 마세요. 실제 처리 모델이 바뀐 뒤에도 기존 V4 Flash 이름이 허용되는 이유는 deepseek-flash 출시 안내에서 설명합니다.

Python으로 짧은 텍스트 응답부터 받기

프로젝트 환경에서 python -m pip install openai로 공식 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"}}'

JSON 본문은 같은 짧은 텍스트 작업을 지정합니다. 실패하면 민감한 정보를 제거한 오류 본문을 보관하세요. 상태 코드만으로는 잘못된 경로나 계정 문제를 놓칠 수 있습니다. 인증 헤더가 포함된 상세 로그를 지원 요청에 그대로 붙이지 마세요.

JavaScript에서는 OpenAI SDK의 baseURL 옵션에 같은 주소를 넣고 같은 모델명과 JSON 필드를 사용합니다. Python 인수 이름을 기계적으로 옮기지 말고 설치된 SDK의 인터페이스를 따르세요.

클라이언트와 프로토콜 맞추기

전체 클라이언트 설정은 Codex 가이드나 Claude Code 가이드를 참고하세요. 텍스트 응답 성공만으로 도구 호출 반복, 이미지 입력 또는 스트리밍 파서까지 검증되는 것은 아닙니다.

모델이 없거나 요청이 실패할 때

먼저 목적지를 확인하고 다음으로 정확한 식별자를 확인하세요. 오래된 클라이언트 목록에는 deepseek-flash가 없을 수 있고, 게이트웨이가 다른 이름을 제공할 수도 있습니다. expires-on-0910 테스트 설정을 정식 모델의 사양으로 받아들이지 마세요. 알 수 없는 모델에 모든 공급자가 같은 오류 코드를 반환한다고 가정하지 말고 실제 응답을 기록해야 합니다.

DeepSeek의 오류 코드 문서는 401 인증, 402 잔액 부족, 400 요청 형식, 422 파라미터, 429 속도 제한을 구분합니다. 잔액 부족이 확인됐을 때 충전이 필요하며, 충전으로 잘못된 본문이나 미지원 모델 이름이 해결되지는 않습니다. 일시적 실패는 간격을 두고 제한적으로 재시도하세요.

대량 작업을 위해 충전하기 전에 요금 계산 가이드를 확인하세요. Ofox를 선택한다면 모델 목록과 인증 안내에서 원하는 경로와 과금 조건을 확인한 뒤 가입하세요. 공식 직접 연결 예시는 게이트웨이에서도 설정이 같다는 주장이 아닙니다.

충전할 서비스를 고르기 전에 API 구매 전 확인 목록에서 모델, 프로토콜과 과금 조건을 확인하세요.