DeepSeek 매개변수 및 프로토콜 차이
호환 프로토콜에서 DeepSeek 모델의 매개변수 차이와 사용 방법을 알아봅니다.
DeepSeek는 이 페이지에 따라 매개변수를 조정하세요. 구조: Chat Completions, Responses, Messages.
| 모델 | 적용 범위 |
|---|
| deepseek-flash | Chat, Responses, Messages. 이미지 지원 |
| deepseek-v4-pro | Chat, Responses, Messages. 이미지 미지원, Responses 서버 검색 지원 |
| 필드 | 차이 설명 |
|---|
thinking.type | 둘 다 기본 추론, enabled/disabled 지원 |
reasoning_effort | none은 끄고 low/high/max은 켬, 기본 high. minimal→low, medium/xhigh→high, ultra→max |
temperature | 범위 0～2, 추론 시 무시 |
top_p | Flash: 추론 시 0.95～1, 0.95 미만은 0.95, 비추론은 1 고정. Pro: 추론 시 전달값 무시, tools 있으면 0.95, 아니면 1; 비추론 시 유효 |
max_tokens | DeepSeek는 계속 사용하며 폐기되지 않음. 범위 1～393216. 비추론 기본 8192, 추론 65536, 강도 max일 때 131072 |
presence_penalty, frequency_penalty | 공식 폐기, 전달해도 무효 |
stop | 문자열 또는 배열, 최대 16개 정지 문자열 |
response_format.type | text/json_object 지원, JSON 모드는 프롬프트에도 JSON 출력 명시 |
tools, tool_choice | Function Tool만. 추론 시 required 또는 함수 지정은 400, 먼저 추론 해제 |
이전 reasoning_content | 추론 시 tools 있으면 도구 없는 턴까지 모든 assistant 추론 재전송. tools 없으면 이력 추론 무시 |
stream_options.include_usage | stream: true과만 사용. 설정 여부와 무관하게 마지막 블록에 전체 Usage, 별도 choices: [] 없음. 켜면 이전 블록의 usage는 null |
user_id | DeepSeek 확장, 최대 512자. 영문, 숫자, 밑줄, 하이픈만. 사용자/캐시/스케줄 분리, 개인정보 제외 |
| 필드 | 차이 설명 |
|---|
input, instructions | 적어도 하나 필요. instructions은 첫 system, developer 역할은 user 취급 |
reasoning.effort | 기본 high, none/low/high/max 지원, 호환 매핑은 위 표. none로 추론 해제 |
temperature, top_p | 값/추론 동작은 위 표와 같고 Flash / Pro 구분 |
previous_response_id, conversation, store | 무상태 API, 전달값 무시. 입출력 이력 재전송, 응답 previous_response_id: null, store: false 고정 |
text.format | text/json_object/json_schema 지원, JSON Schema는 name, schema 필요 |
text.verbosity, reasoning.summary | 전자는 무효, 후자는 요약 생성 안 함. reasoning 이력은 평문 content만, summary/encrypted_content 미지원 |
tools | Function Tool 지원, Custom Tool 이름은 apply_patch만, 나머지 400. web_search는 Pro만, Flash 무시; file_search, code_interpreter, computer_use, mcp 무시 |
tool_choice | none/auto/required 및 Function Tool 지정 지원 |
parallel_tool_calls, max_tool_calls | 값 무시, 병렬 항상 켜짐, 응답 parallel_tool_calls은 true 고정 |
truncation | 무시, 자동 자르기 없음. 입력 컨텍스트 초과 400 |
background, metadata, include, prompt | 전달값 무시 |
service_tier, safety_identifier, context_management, stream_options | 전달값 무시 |
| 필드 | 차이 설명 |
|---|
anthropic-version | DeepSeek는 Header를 무시하고 Anthropic 버전 날짜로 규칙을 바꾸지 않음 |
thinking, output_config.effort | 기본 추론. thinking.type은 enabled/disabled, budget_tokens는 무시. 강도 low/high/max, 기본 high, Chat 매핑 적용. output_config는 effort만 |
temperature, top_p | 값과 동작은 Chat, top_k 무시 |
tool_choice.type | none/auto/any/tool 지원, disable_parallel_tool_use 무시 |
metadata | user_id만, 다른 필드 무시 |
container, mcp_servers, service_tier | 전달값 무시 |
| 텍스트 및 도구 결과 | 텍스트 citations, 결과 is_error 무시. 캐시 표 참고 |
| 콘텐츠 블록 | document, search_result, redacted_thinking, code_execution_tool_result, mcp_tool_use, mcp_tool_result, container_upload 미지원 |
| 필드 | 차이 설명 |
|---|
| 자동 접두사 캐시 | 기본 자동 활성화, 설정 불필요. 저장된 접두사 단위가 완전히 일치해야 적중 가능, 임의의 동일 조각은 보장 안 함 |
Responses의 prompt_cache_key, prompt_cache_retention | 전달값 무시, 캐시 자동 관리 |
Messages의 cache_control | 블록과 도구 정의의 표시 무시 |
| 캐시 사용량 | Chat usage.prompt_cache_hit_tokens, usage.prompt_cache_miss_tokens, Responses usage.input_tokens_details.cached_tokens 확인 |
이미지는 deepseek-flash만 지원, deepseek-v4-pro 미지원입니다.
MODEL_ID을 전체 ID로 바꾸고 본인 API Key를 사용하세요.
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"max_tokens": 4096
}'