# DeepSeek v4 API DeepSeek가 구동하는 DeepSeek v4 LLM 모델의 전체 API 레퍼런스입니다. ## 모델 업데이트 ### DeepSeek v4 Pro 0813 - Flaq AI는 DeepSeek v4 Pro를 DeepSeek의 공식 `deepseek-v4-pro-0813` 릴리스로 업데이트했습니다. - 공식 버전에 액세스하려면 아래의 `0813` 모델 ID를 사용하세요. - 기존 Pro 모델 ID는 사용할 수 없습니다. | 변형 | 0813 모델 ID | 사용할 수 없는 모델 ID | |---------|---------------|----------------------| | 텍스트-텍스트 | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | 웹 검색 | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI는 DeepSeek v4 Flash를 DeepSeek의 공식 `deepseek-v4-flash-0731` 릴리스로 업데이트했습니다. - 업데이트된 버전에 액세스하려면 아래의 `0731` 모델 ID를 사용하세요. - 기존 Flash 모델 ID는 사용할 수 없습니다. | 변형 | 0731 모델 ID | 사용할 수 없는 모델 ID | |---------|---------------|----------------------| | 텍스트-텍스트 | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | 웹 검색 | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## 모델 변형 이 API는 네 가지 DeepSeek v4 모델 변형을 지원합니다. | 모델 | ID | 설명 | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | 고품질 텍스트 추론 및 작성 | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | 더 빠르고 경제적인 텍스트 생성 | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | DeepSeek v4 Pro 추론을 활용한 웹 인식 답변 | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | DeepSeek v4 Flash를 활용한 더 빠른 웹 인식 답변 | ## 빠른 비교 | 기능 | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | 텍스트 입력 | 필수 ✅ | 필수 ✅ | 필수 ✅ | 필수 ✅ | | 이미지 입력 | 지원 안 함 ❌ | 지원 안 함 ❌ | 지원 안 함 ❌ | 지원 안 함 ❌ | | 파일 입력 | 지원 안 함 ❌ | 지원 안 함 ❌ | 지원 안 함 ❌ | 지원 안 함 ❌ | | Web search | 지원 안 함 ❌ | 지원 안 함 ❌ | 활성화됨 ✅ | 활성화됨 ✅ | | 스트리밍 응답 | SSE | SSE | SSE | SSE | | `max_tokens` | 선택 사항 | 선택 사항 | 선택 사항 | 선택 사항 | | `top_p` | 선택 사항 | 선택 사항 | 선택 사항 | 선택 사항 | | `top_k` | 선택 사항 | 선택 사항 | 선택 사항 | 선택 사항 | ## DeepSeek v4 Pro Text to Text ### 엔드포인트 ```http POST /api/v1/chat/completions ``` ### 요청 파라미터 #### 필수 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `model` | string | 반드시 `"deepseek-v4-pro-text-to-text-0813"`여야 합니다 | | `messages` | array | 순서가 있는 텍스트 전용 메시지입니다. `system`, `user`, `assistant` 역할을 지원합니다. 메시지 구조는 LLM API를 참조하세요. | | `stream` | boolean | SSE에는 `true`, 단일 JSON 응답에는 `false`를 사용합니다. | #### 메시지 지원 | 필드 | 텍스트 | 파일 | 이미지 | |-------|------|------|-------| | `messages` | 필수 ✅ | 지원 안 함 ❌ | 지원 안 함 ❌ | #### 선택 사항 | 파라미터 | 유형 | 범위 | 설명 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 최대 출력 token 수입니다. | | `top_p` | number | `0.0` - `1.0` | 후보 token의 누적 확률 질량을 제한합니다. | | `top_k` | integer | `0` - `100` | 후보 token 수를 제한합니다. | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### 엔드포인트 ```http POST /api/v1/chat/completions ``` ### 요청 파라미터 #### 필수 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `model` | string | 반드시 `"deepseek-v4-flash-text-to-text-0731"`여야 합니다 | | `messages` | array | 순서가 있는 텍스트 전용 메시지입니다. `system`, `user`, `assistant` 역할을 지원합니다. 메시지 구조는 LLM API를 참조하세요. | | `stream` | boolean | SSE에는 `true`, 단일 JSON 응답에는 `false`를 사용합니다. | #### 메시지 지원 | 필드 | 텍스트 | 파일 | 이미지 | |-------|------|------|-------| | `messages` | 필수 ✅ | 지원 안 함 ❌ | 지원 안 함 ❌ | #### 선택 사항 | 파라미터 | 유형 | 범위 | 설명 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 최대 출력 token 수입니다. | | `top_p` | number | `0.0` - `1.0` | 후보 token의 누적 확률 질량을 제한합니다. | | `top_k` | integer | `0` - `100` | 후보 token 수를 제한합니다. | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### 엔드포인트 ```http POST /api/v1/chat/completions ``` ### 요청 파라미터 #### 필수 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `model` | string | 반드시 `"deepseek-v4-pro-web-search-0813"`여야 합니다 | | `messages` | array | 순서가 있는 텍스트 전용 메시지입니다. `system`, `user`, `assistant` 역할을 지원합니다. 메시지 구조는 LLM API를 참조하세요. | | `stream` | boolean | SSE에는 `true`, 단일 JSON 응답에는 `false`를 사용합니다. | #### 메시지 지원 | 필드 | 텍스트 | 파일 | 이미지 | |-------|------|------|-------| | `messages` | 필수 ✅ | 지원 안 함 ❌ | 지원 안 함 ❌ | #### 선택 사항 | 파라미터 | 유형 | 범위 | 설명 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 최대 출력 token 수입니다. | | `top_p` | number | `0.0` - `1.0` | 후보 token의 누적 확률 질량을 제한합니다. | | `top_k` | integer | `0` - `100` | 후보 token 수를 제한합니다. | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### 엔드포인트 ```http POST /api/v1/chat/completions ``` ### 요청 파라미터 #### 필수 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `model` | string | 반드시 `"deepseek-v4-flash-web-search-0731"`여야 합니다 | | `messages` | array | 순서가 있는 텍스트 전용 메시지입니다. `system`, `user`, `assistant` 역할을 지원합니다. 메시지 구조는 LLM API를 참조하세요. | | `stream` | boolean | SSE에는 `true`, 단일 JSON 응답에는 `false`를 사용합니다. | #### 메시지 지원 | 필드 | 텍스트 | 파일 | 이미지 | |-------|------|------|-------| | `messages` | 필수 ✅ | 지원 안 함 ❌ | 지원 안 함 ❌ | #### 선택 사항 | 파라미터 | 유형 | 범위 | 설명 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 최대 출력 token 수입니다. | | `top_p` | number | `0.0` - `1.0` | 후보 token의 누적 확률 질량을 제한합니다. | | `top_k` | integer | `0` - `100` | 후보 token 수를 제한합니다. | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## 응답 형식 DeepSeek V4 LLM 모델은 OpenAI 호환 completion 응답을 반환합니다. `stream: true`이면 응답은 Server-Sent Events(SSE)이며, `stream: false`이면 단일 JSON 객체입니다. ### 오류 응답 ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## 모범 사례 1. **올바른 변형 선택:** 더 높은 품질의 추론에는 Pro 모델을, 낮은 지연 시간과 낮은 비용의 워크로드에는 Flash 모델을 사용하세요. 2. **최신 이벤트에는 Web Search 사용:** 답변이 최신 온라인 정보에 의존할 때 Pro 또는 Flash Web Search를 선택하세요. 3. **샘플링 파라미터를 신중하게 조정:** `top_p`와 `top_k`는 모든 DeepSeek v4 변형에서 지원되며 출력 다양성을 바꿀 수 있습니다. 4. **지원되는 입력만 전송:** 어떤 DeepSeek v4 route에도 파일 또는 이미지 파트를 보내지 마세요. 5. **Accept를 stream 모드와 맞춤:** 스트리밍 요청에는 `Accept: text/event-stream`을, 비스트리밍 요청에는 `Accept: application/json`을 사용하세요.