# API DeepSeek v4 Referensi API lengkap untuk model LLM DeepSeek v4 yang didukung oleh DeepSeek. ## Pembaruan Model ### DeepSeek v4 Pro 0813 - Flaq AI telah memperbarui DeepSeek v4 Pro ke rilis resmi DeepSeek `deepseek-v4-pro-0813`. - Gunakan ID model `0813` di bawah ini untuk mengakses versi resmi. - ID model Pro asli tidak tersedia. | Varian | ID Model 0813 | ID Model Tidak Tersedia | |---------|---------------|----------------------| | Teks ke Teks | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Pencarian Web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI telah memperbarui DeepSeek v4 Flash ke rilis resmi DeepSeek `deepseek-v4-flash-0731`. - Gunakan ID model dengan `0731` di bawah ini untuk mengakses versi yang telah diperbarui. - ID model Flash asli tidak tersedia. | Varian | ID Model 0731 | ID Model Tidak Tersedia | |---------|---------------|-------------------| | Teks ke Teks | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Pencarian Web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Varian Model API ini mendukung empat varian model DeepSeek v4: | Model | ID | Deskripsi | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Penalaran dan penulisan teks berkualitas tinggi | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Generasi teks yang lebih cepat dan lebih terjangkau | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Jawaban sadar web dengan penalaran DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Jawaban sadar web yang lebih cepat dengan DeepSeek v4 Flash | ## Perbandingan Cepat | Fitur | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Input teks | Wajib ✅ | Wajib ✅ | Wajib ✅ | Wajib ✅ | | Input gambar | Tidak didukung ❌ | Tidak didukung ❌ | Tidak didukung ❌ | Tidak didukung ❌ | | Input file | Tidak didukung ❌ | Tidak didukung ❌ | Tidak didukung ❌ | Tidak didukung ❌ | | Web search | Tidak didukung ❌ | Tidak didukung ❌ | Aktif ✅ | Aktif ✅ | | Respons streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Opsional | Opsional | Opsional | Opsional | | `top_p` | Opsional | Opsional | Opsional | Opsional | | `top_k` | Opsional | Opsional | Opsional | Opsional | ## DeepSeek v4 Pro Text to Text ### Titik Akhir ```http POST /api/v1/chat/completions ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model` | string | Harus `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Pesan khusus teks yang berurutan. Mendukung peran `system`, `user`, dan `assistant`. Lihat LLM API untuk struktur pesan. | | `stream` | boolean | `true` untuk SSE, `false` untuk satu respons JSON. | #### Dukungan Pesan | Kolom | Teks | Berkas | Gambar | |-------|------|------|-------| | `messages` | Wajib ✅ | Tidak didukung ❌ | Tidak didukung ❌ | #### Opsional | Parameter | Tipe | Rentang | Deskripsi | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Token output maksimum. | | `top_p` | number | `0.0` - `1.0` | Membatasi massa probabilitas kumulatif untuk token kandidat. | | `top_k` | integer | `0` - `100` | Membatasi jumlah token kandidat. | ### Contoh Permintaan ```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 ### Titik Akhir ```http POST /api/v1/chat/completions ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model` | string | Harus `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Pesan khusus teks yang berurutan. Mendukung peran `system`, `user`, dan `assistant`. Lihat LLM API untuk struktur pesan. | | `stream` | boolean | `true` untuk SSE, `false` untuk satu respons JSON. | #### Dukungan Pesan | Kolom | Teks | Berkas | Gambar | |-------|------|------|-------| | `messages` | Wajib ✅ | Tidak didukung ❌ | Tidak didukung ❌ | #### Opsional | Parameter | Tipe | Rentang | Deskripsi | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Token output maksimum. | | `top_p` | number | `0.0` - `1.0` | Membatasi massa probabilitas kumulatif untuk token kandidat. | | `top_k` | integer | `0` - `100` | Membatasi jumlah token kandidat. | ### Contoh Permintaan ```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 ### Titik Akhir ```http POST /api/v1/chat/completions ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model` | string | Harus `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Pesan khusus teks yang berurutan. Mendukung peran `system`, `user`, dan `assistant`. Lihat LLM API untuk struktur pesan. | | `stream` | boolean | `true` untuk SSE, `false` untuk satu respons JSON. | #### Dukungan Pesan | Kolom | Teks | Berkas | Gambar | |-------|------|------|-------| | `messages` | Wajib ✅ | Tidak didukung ❌ | Tidak didukung ❌ | #### Opsional | Parameter | Tipe | Rentang | Deskripsi | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Token output maksimum. | | `top_p` | number | `0.0` - `1.0` | Membatasi massa probabilitas kumulatif untuk token kandidat. | | `top_k` | integer | `0` - `100` | Membatasi jumlah token kandidat. | ### Contoh Permintaan ```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 ### Titik Akhir ```http POST /api/v1/chat/completions ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model` | string | Harus `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Pesan khusus teks yang berurutan. Mendukung peran `system`, `user`, dan `assistant`. Lihat LLM API untuk struktur pesan. | | `stream` | boolean | `true` untuk SSE, `false` untuk satu respons JSON. | #### Dukungan Pesan | Kolom | Teks | Berkas | Gambar | |-------|------|------|-------| | `messages` | Wajib ✅ | Tidak didukung ❌ | Tidak didukung ❌ | #### Opsional | Parameter | Tipe | Rentang | Deskripsi | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Token output maksimum. | | `top_p` | number | `0.0` - `1.0` | Membatasi massa probabilitas kumulatif untuk token kandidat. | | `top_k` | integer | `0` - `100` | Membatasi jumlah token kandidat. | ### Contoh Permintaan ```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 }) }); ``` ## Format Respons Model LLM DeepSeek V4 mengembalikan respons completion yang kompatibel dengan OpenAI. Dengan `stream: true`, respons berupa Server-Sent Events; dengan `stream: false`, respons berupa satu objek JSON. ### Respons Kesalahan ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Praktik Terbaik 1. **Pilih varian yang tepat:** Gunakan model Pro untuk penalaran berkualitas lebih tinggi dan model Flash untuk beban kerja berlatensi lebih rendah dan biaya lebih rendah. 2. **Gunakan Web Search untuk peristiwa terkini:** Pilih Pro atau Flash Web Search saat jawaban bergantung pada informasi online terbaru. 3. **Atur parameter sampling dengan cermat:** `top_p` dan `top_k` didukung di semua varian DeepSeek v4 dan dapat mengubah keragaman output. 4. **Kirim hanya input yang didukung:** Jangan kirim bagian file atau gambar ke route DeepSeek v4 mana pun. 5. **Sesuaikan Accept dengan mode stream:** Gunakan `Accept: text/event-stream` untuk permintaan streaming dan `Accept: application/json` untuk permintaan non-streaming.