소개
DeepSeek V4 Flash는 처리량에 초점을 둔 DeepSeek의 장문 컨텍스트 모델로, 여기서는 /v1/chat/completions의 OpenAI 호환 엔드포인트 하나로 제공합니다. 요청 하나에 최대 256개 메시지, 입력 1,048,576토큰까지 받고 최대 65,536토큰을 돌려주며, 추론 강도 기본값은 high입니다.
메시지 내용은 텍스트만 받습니다. tool_choice와 함께 도구 최대 128개, response_format을 통한 JSON 출력, SSE 스트리밍을 같은 호출에서 쓸 수 있고, 과금은 입력, 캐시 입력, 출력으로 나뉩니다.
핵심 기능 및 하이라이트
같은 본문으로 저렴한 처리와 꼼꼼한 처리
reasoning_effort 기본값은 high이고, 대량 처리에는 low를 씁니다. 전환은 같은 본문의 문자열 하나이므로, 레코드 천 건을 훑는 첫 처리와 이상해 보인 마흔 건을 다시 보는 두 번째 처리가 같은 연동 안에서 돌아갑니다.
저장소를 읽고 결과를 돌려줍니다
창은 1,048,576토큰이고 응답 하나는 최대 65,536토큰입니다. 이 비율이 작업의 형태입니다. 서비스 전체를 넣고 리뷰나 우선순위를 매긴 문제 목록, 정확히 겨냥한 패치를 요청하세요. 보낸 것을 전부 다시 써 달라는 용도가 아닙니다.
요청하면 JSON으로
response_format을 json_object로 두고 system 메시지에 필드 이름을 모두 적으면 매번 같은 형태로 돌아옵니다. 그래도 애플리케이션은 받은 내용을 파싱하고 검증한 뒤에 사용해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | 오래된 것부터 순서대로, 최대 256개입니다. 내용은 텍스트만 되고, reasoning_content는 assistant 메시지에서 유효합니다. 1개 이상 · 256개 이하 |
reasoning_effort | 아니요 | none, low, high 중 하나이고 기본값은 high입니다. none은 추론 단계를 통째로 건너뛰므로 추론 토큰이 청구에 들어가지 않는 유일한 설정입니다(추론 토큰은 출력으로 과금됩니다). |
stop | 아니요 | 최대 4개의 정지 시퀀스를 문자열 또는 배열로 지정합니다. 모델이 그중 하나를 쓰는 즉시 응답이 끝나며, 일치한 텍스트 자체는 반환되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
max_tokens | 아니요 | 응답을 65,536에서 자릅니다. 기본값은 32,768이라 긴 결과물이 조용히 잘립니다. |
tools | 아니요 | 요청 하나에 함수 정의를 최대 128개까지 넣습니다. 128개 이하 |
tool_choice | 아니요 | auto, none, required, 또는 함수 하나를 지정한 객체입니다. |
response_format | 아니요 | 응답을 사람이 아니라 파서가 받는 경우라면 JSON 객체를 요청하세요. |
요금
입력 $0.44 / 출력 $1.32 100만 토큰당
활용 사례
저장소 전체 리뷰
서비스와 테스트, 관련 명세를 함께 보내고 모든 문제에 파일, 줄, 영향을 받는 동작을 적도록 요구하세요. 코드베이스 전체가 맥락에 있으니 짐작하지 않고 두 패키지 떨어진 호출부까지 짚을 수 있습니다.
계약서 묶음을 JSON으로
계약서 묶음을 response_format json_object로 보내고, 파싱된 조항을 바로 표에 옮기세요. 필드 이름은 system 메시지에 적고, 대량 처리에서는 추론 강도를 low로 둡니다.
저렴하게 초안을 내고 어려운 건만 다시
대기열 전체를 low로 돌리고 점검을 통과하지 못한 레코드만 표시한 뒤, 같은 메시지 배열로 high에서 다시 보냅니다. 두 응답 사이에 달라진 것은 추론 강도 필드뿐입니다.
프롬프트 가이드 및 실전 팁
OpenAI 형식의 호출 한 번
POST https://api.spicyapi.ai/v1/chat/completions에 {"model": "deepseek/v4-flash", "messages": [{"role": "system", "content": "You review Go services. Report only defects you can point to by file and line."}, {"role": "user", "content": "<the whole service>"}], "reasoning_effort": "high", "max_tokens": 8000}을 보냅니다. 토큰을 도착하는 대로 읽으려면 "stream": true를 추가하세요.
max_tokens는 결과물 크기에 맞추세요
기본값 32,768은 긴 결과물을 오류 없이 잘라 버리고, 상한은 65,536입니다. 추론 토큰도 출력으로 과금되므로 눈에 보이는 응답보다 여유를 두세요.
스키마가 거부하는 것
image_url과 파일 파트는 요금 산정 전에 거부되고, reasoning_content는 assistant 메시지에서만 받으며, 1,048,576토큰 창에는 system 프롬프트와 이전 도구 결과를 포함한 모든 메시지가 들어갑니다. 캐시 적중 시에는 이 엔드포인트가 DeepSeek 자체 가격보다 싸지 않으니, 긴 프롬프트를 계속 다시 보내는 방식이라면 미리 비교하세요.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "deepseek/v4-flash/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.









