DeepSeek V4 - OpenAI 호환 인터페이스

채팅 모델 이름

• deepseek-v4-flash: 빠른 범용 모델, 1M 컨텍스트
• deepseek-v4-pro: 심층 추론 모델, 수학·프로그래밍 및 복잡한 논리에 능숙
• deepseek-v4-flash-vision-exp: Flash 기반으로 네이티브 이미지 이해를 추가한 실험 모델이며 텍스트 성능, 매개변수, 가격은 Flash와 동일합니다

팁: 세 모델 모두 기본적으로 thinking이 활성화되어 있어 응답에 reasoning_content가 포함됩니다. 출력 token 비용을 낮추려면 thinking.type="disabled"로 끌 수 있습니다.

이미지는 deepseek-v4-flash-vision-exp만 지원합니다: deepseek-v4-flash / deepseek-v4-pro에 이미지를 보내면 HTTP 400 This model does not support image가 반환됩니다.

실험 버전 안내: -exp는 업스트림 실험 버전을 뜻합니다. 모델 이름과 가용성이 변경될 수 있으므로 프로덕션에서는 대체 경로를 마련하세요.

샘플링 온도, 출력의 무작위성을 제어합니다

설명:

• 낮은 값(예: 0.2): 더 결정적이고 집중된 출력
• 높은 값(예: 1.5): 더 무작위적이고 창의적인 출력
• 기본값: 1

Nucleus Sampling (핵 샘플링) 매개변수

설명:

• 누적 확률 상위 몇 %의 token에서 샘플링할지 제어합니다
• 예를 들어 0.9는 누적 확률 90%까지의 token 중에서 선택합니다
• 기본값: 1.0 (모든 token 고려)

권장: temperature와 top_p를 동시에 조정하지 마세요

생성 콘텐츠의 최대 token 수 제한

설명:

• V4 시리즈는 최대 384,000 tokens까지 가능
• thinking 활성화 시 reasoning_tokens도 max_tokens 상한에 포함됩니다
• 설정하지 않으면 모델이 생성 길이를 스스로 결정합니다

중지 시퀀스, 모델이 이 문자열을 만나면 생성을 중단합니다

설명:

• 단일 문자열 또는 문자열 배열일 수 있습니다
• 최대 16개의 중지 시퀀스 지원

응답을 스트리밍 방식으로 반환할지 여부

• true: 스트리밍 반환, SSE(Server-Sent Events)를 통해 청크 단위로 실시간 반환
• false: 완전한 응답을 기다린 후 한 번에 반환 (기본값)

도구 호출 동작 제어

가능한 값:

• none: 어떤 도구도 호출하지 않음
• auto: 모델이 도구 호출 여부를 자동 결정 (tools 제공 시 기본값)
• required: 모델이 하나 이상의 도구를 반드시 호출하도록 강제
• 객체 형식 {"type":"function","function":{"name":"xxx"}}: 특정 도구를 지정하여 호출

기본값: tools 미제공 시 none, tools 제공 시 auto

token의 로그 확률을 반환할지 여부

설명:

• true로 설정하면 응답에 각 token의 로그 확률 정보가 포함됩니다

확률 상위 N개 token의 로그 확률 반환

설명:

• logprobs가 true로 설정되어야 합니다
• 값 범위: [0, 20]

채팅 완성의 고유 식별자

실제 사용된 모델 이름

응답 유형

생성 타임스탬프 (Unix 초)

시스템 지문 식별자