# DeepSeek v4 API เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดล DeepSeek v4 LLM ที่ขับเคลื่อนโดย DeepSeek ## การอัปเดตโมเดล ### DeepSeek v4 Pro 0813 - Flaq AI ได้อัปเดต DeepSeek v4 Pro เป็นรุ่น `deepseek-v4-pro-0813` อย่างเป็นทางการของ DeepSeek - ใช้ ID โมเดล `0813` ด้านล่างเพื่อเข้าถึงเวอร์ชันอย่างเป็นทางการ - ID โมเดล Pro เดิมไม่สามารถใช้งานได้ | รุ่น | ID โมเดล 0813 | 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-v4-flash-0731` อย่างเป็นทางการของ DeepSeek. - ใช้ ID โมเดล `0731` ด้านล่างเพื่อเข้าถึงเวอร์ชันที่อัปเดตแล้ว. - ID โมเดล Flash เดิมไม่สามารถใช้งานได้ | รุ่น | ID โมเดล 0731 | 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 สี่แบบ: | โมเดล | รหัส | คำอธิบาย | |-------|----|-------------| | **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 | |---------|------------------|------------|----------------|------------------| | อินพุตข้อความ | จำเป็น ✅ | จำเป็น ✅ | จำเป็น ✅ | จำเป็น ✅ | | อินพุตรูปภาพ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | | อินพุตไฟล์ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | | การค้นเว็บ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | เปิดใช้งาน ✅ | เปิดใช้งาน ✅ | | การตอบกลับแบบสตรีม | 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 | `true` สำหรับ SSE, `false` สำหรับการตอบกลับ JSON เดียว | #### การรองรับข้อความ | ฟิลด์ | ข้อความ | ไฟล์ | รูปภาพ | |-------|------|------|-------| | `messages` | จำเป็น ✅ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | ช่วง | คำอธิบาย | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | จำนวนโทเคนเอาต์พุตสูงสุด | | `top_p` | number | `0.0` - `1.0` | จำกัดมวลความน่าจะเป็นสะสมสำหรับโทเคนตัวเลือก | | `top_k` | integer | `0` - `100` | จำกัดจำนวนโทเคนตัวเลือก | ### ตัวอย่างคำขอ ```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 | `true` สำหรับ SSE, `false` สำหรับการตอบกลับ JSON เดียว | #### การรองรับข้อความ | ฟิลด์ | ข้อความ | ไฟล์ | รูปภาพ | |-------|------|------|-------| | `messages` | จำเป็น ✅ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | ช่วง | คำอธิบาย | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | จำนวนโทเคนเอาต์พุตสูงสุด | | `top_p` | number | `0.0` - `1.0` | จำกัดมวลความน่าจะเป็นสะสมสำหรับโทเคนตัวเลือก | | `top_k` | integer | `0` - `100` | จำกัดจำนวนโทเคนตัวเลือก | ### ตัวอย่างคำขอ ```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 | `true` สำหรับ SSE, `false` สำหรับการตอบกลับ JSON เดียว | #### การรองรับข้อความ | ฟิลด์ | ข้อความ | ไฟล์ | รูปภาพ | |-------|------|------|-------| | `messages` | จำเป็น ✅ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | ช่วง | คำอธิบาย | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | จำนวนโทเคนเอาต์พุตสูงสุด | | `top_p` | number | `0.0` - `1.0` | จำกัดมวลความน่าจะเป็นสะสมสำหรับโทเคนตัวเลือก | | `top_k` | integer | `0` - `100` | จำกัดจำนวนโทเคนตัวเลือก | ### ตัวอย่างคำขอ ```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 | `true` สำหรับ SSE, `false` สำหรับการตอบกลับ JSON เดียว | #### การรองรับข้อความ | ฟิลด์ | ข้อความ | ไฟล์ | รูปภาพ | |-------|------|------|-------| | `messages` | จำเป็น ✅ | ไม่รองรับ ❌ | ไม่รองรับ ❌ | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | ช่วง | คำอธิบาย | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | จำนวนโทเคนเอาต์พุตสูงสุด | | `top_p` | number | `0.0` - `1.0` | จำกัดมวลความน่าจะเป็นสะสมสำหรับโทเคนตัวเลือก | | `top_k` | integer | `0` - `100` | จำกัดจำนวนโทเคนตัวเลือก | ### ตัวอย่างคำขอ ```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 }) }); ``` ## รูปแบบการตอบกลับ โมเดล LLM DeepSeek V4 ส่งคืนการตอบกลับแบบ completion ที่เข้ากันได้กับ OpenAI เมื่อใช้ `stream: true` การตอบกลับจะอยู่ในรูปแบบ Server-Sent Events; เมื่อใช้ `stream: false` การตอบกลับจะเป็นออบเจ็กต์ JSON เดียว ### การตอบกลับข้อผิดพลาด ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## แนวทางปฏิบัติที่ดีที่สุด 1. **เลือกรุ่นให้เหมาะสม:** ใช้โมเดล Pro สำหรับการให้เหตุผลคุณภาพสูง และใช้โมเดล Flash สำหรับงานที่ต้องการ latency ต่ำและต้นทุนต่ำ 2. **ใช้ Web Search สำหรับเหตุการณ์ปัจจุบัน:** เลือก Pro หรือ Flash Web Search เมื่อคำตอบขึ้นอยู่กับข้อมูลออนไลน์ล่าสุด 3. **ปรับพารามิเตอร์ sampling อย่างระมัดระวัง:** รองรับ `top_p` และ `top_k` ใน DeepSeek v4 ทุกรุ่น และอาจเปลี่ยนความหลากหลายของเอาต์พุตได้ 4. **ส่งเฉพาะอินพุตที่รองรับ:** อย่าส่งส่วนของไฟล์หรือรูปภาพไปยัง route ใดๆ ของ DeepSeek v4 5. **จับคู่ Accept กับโหมด stream:** ใช้ `Accept: text/event-stream` สำหรับคำขอแบบสตรีม และ `Accept: application/json` สำหรับคำขอที่ไม่สตรีม