# DeepSeek v4 API مرجع API كامل لنماذج DeepSeek v4 LLM المدعومة من DeepSeek. ## تحديثات النموذج ### DeepSeek v4 Pro 0813 - حدّثت Flaq AI نموذج DeepSeek v4 Pro إلى إصدار DeepSeek الرسمي `deepseek-v4-pro-0813`. - استخدم معرّفات النماذج التي تتضمن `0813` أدناه للوصول إلى الإصدار الرسمي. - معرّفات نماذج Pro الأصلية غير متاحة. | المتغير | معرّف نموذج 0813 | معرّف النموذج غير المتاح | |---------|---------------|----------------------| | نص إلى نص | `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` أدناه للوصول إلى الإصدار المحدّث. - معرّفات نماذج Flash الأصلية غير متاحة. | المتغير | معرّف نموذج 0731 | معرّف النموذج غير المتاح | |---------|---------------|-------------------| | نص إلى نص | `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 }) }); ``` ## تنسيق الاستجابة تعيد نماذج DeepSeek V4 اللغوية الكبيرة استجابات إكمال متوافقة مع 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 لأعباء العمل الأقل زمنا وتكلفة. 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` لطلبات streaming و`Accept: application/json` للطلبات غير المتدفقة.