소개
DeepSeek V4 Pro는 DeepSeek V4 두 모델 가운데 신중하게 생각하는 쪽으로, 여기서는 /v1/chat/completions의 OpenAI 호환 엔드포인트 하나로 제공합니다. 최대 1,048,576토큰을 읽고 기본적으로 추론 강도 high로 생각하며, 응답 하나로 최대 384,000토큰까지 쓸 수 있습니다.
low는 빠른 초안용입니다. 메시지 내용은 텍스트만 가능하고 요청당 최대 256개이며, 도구 최대 128개, response_format을 통한 JSON 출력, SSE 스트리밍을 쓸 수 있고, 입력과 캐시 입력, 출력은 따로 계량됩니다.
핵심 기능 및 하이라이트
출발점은 high
추가 추론이 값을 하는 곳은 리뷰, 마이그레이션, 보안 작업이므로 이 엔드포인트는 high에서 시작하고 low는 초안에 맡깁니다. 추론은 출력 토큰으로 소비되므로 별도 요금이 아니라 같은 청구서에 올라가고, 지정한 max_tokens에도 똑같이 계산됩니다.
명세, 코드, 테스트를 요청 하나에
1,048,576토큰이면 설계 문서와 구현, 테스트 스위트를 함께 보낼 수 있어서, 모델이 당신의 요약을 믿는 대신 셋을 직접 비교합니다. 불변 조건은 system 메시지에, 자료는 그 아래 오래된 순서로 두면 모든 불일치가 모델이 인용할 수 있는 지점에 묶입니다.
답을 통째로 쓸 공간
응답 하나가 최대 384,000토큰이므로 순서가 정해진 계획과 단계별 SQL, 이를 검증할 쿼리가 한 응답에 들어갑니다. 기본값 32,768은 오류 없이 잘리므로 max_tokens는 결과물에 맞춰 정하세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | 순서대로 최대 256개 턴이고 내용은 텍스트만입니다. assistant 턴의 reasoning_content를 되돌려 보내면 tool 대화의 맥락이 유지됩니다. 1개 이상 · 256개 이하 |
reasoning_effort | 아니요 | none, low, high 중 하나이고 기본값은 high입니다. none은 추론 단계를 통째로 건너뛰므로 추론 토큰이 청구에 들어가지 않는 유일한 설정입니다(추론 토큰은 출력으로 과금됩니다). |
stop | 아니요 | 최대 4개의 정지 시퀀스를 문자열 또는 배열로 지정합니다. 모델이 그중 하나를 쓰는 즉시 응답이 끝나며, 일치한 텍스트 자체는 반환되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
max_tokens | 아니요 | 응답을 384,000에서 자릅니다. 기본값 32,768은 마이그레이션 계획을 오류 없이 잘라 버립니다. |
tools | 아니요 | 요청당 함수 정의 최대 128개입니다. 128개 이하 |
parallel_tool_calls | 아니요 | true 또는 false이며 기본값은 true입니다. true이면 모델이 한 턴에 여러 도구 호출을 요청할 수 있습니다. 기본값: |
tool_choice | 아니요 | auto, none, required, 또는 호출할 함수를 지정한 객체입니다. |
response_format | 아니요 | 답을 코드가 받아 쓰는 경우라면 JSON 객체를 요청하세요. |
요금
입력 $1.32 / 출력 $3.96 100만 토큰당
활용 사례
명세와 구현 대조 감사
설계 문서와 그것을 구현했다는 코드를 요청 하나로 보내고, 모든 불일치를 영향 범위 순으로 요구하세요. 어느 쪽도 요약할 필요가 없으니 빠진 불변 조건이 기억이 아니라 비교로 드러납니다.
high로 하는 보안 점검
인증 경로나 자금 이동 흐름에 high를 겨누고, 스타일 지적이 아니라 악용 가능한 순서를 요구하세요. 추론을 늘리는 비용은 출력 토큰이지만, 권한 상승 경로를 놓치는 비용은 그와 비교가 안 됩니다.
스키마 전체의 마이그레이션 계획
마이그레이션 파일 전부와 현재 테이블 정의를 주고, 단계마다 롤백이 붙은 순서 있는 계획을 요청하세요. 계획과 SQL, 검증 쿼리가 한 응답에 함께 돌아옵니다.
프롬프트 가이드 및 실전 팁
합격 기준을 system 메시지에 쓰세요
모호한 요청에는 high 추론이 낭비됩니다. 자료를 붙이기 전에 올바른 답이 담아야 할 것, 예컨대 파일 참조가 달린 불일치, 순위 목록, 단계별 롤백을 밝혀서 모델이 무언가에 비추어 점검하게 하세요.
작업에 맞는 추론 강도로 한 번 호출
POST https://api.spicyapi.ai/v1/chat/completions에 {"model": "deepseek/v4-pro", "messages": [{"role": "system", "content": "Compare the specification against the implementation. List every divergence with file references, then rank by blast radius."}, {"role": "user", "content": "<spec>\n\n<implementation>"}], "reasoning_effort": "high", "max_tokens": 32000}을 보냅니다. 조치하기 전에 가장 높은 순위의 결과는 직접 확인하세요. high는 더 꼼꼼할 뿐 틀리지 않는 것은 아닙니다.
실패하는 요청 형태
image_url과 파일 파트는 스키마에서 거부되므로, 멀티모달 모델에서 복사한 본문은 요금 산정 전에 실패합니다. 384,000을 넘는 max_tokens는 유효하지 않으며, 1,048,576토큰 창에는 system 프롬프트와 이전 도구 결과가 모두 포함됩니다.
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-pro/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 레퍼런스에서 확인하세요.
