نماذج DeepSeek | وثائق API

# DeepSeek Models

DeepSeek V4 Flash, V4 Pro, and V4.1 Flash model IDs and Chat Completions availability.

POST https://api.apihop.ai/v1/chat-completions

DeepSeek models use the Common Chat Completions endpoint. To switch models, change only the `model` value; the endpoint and authentication stay the same.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Models

| `model` value | Positioning | Non-streaming | SSE streaming |
| --- | --- | --- | --- |
| `deepseek-v4-flash` | Flash tier and a practical starting point for routine chat or batch evaluations | Yes | Yes |
| `deepseek-v4-pro` | Pro tier for evaluations that prioritize complex reasoning and output quality | Yes | Yes |
| `deepseek-v4.1-flash` | DeepSeek V4.1 Flash; a distinct model ID, not a V4 Flash alias | After deployment and enablement | After deployment and enablement |

V4.1 Flash becomes available only after its routing configuration is deployed and enabled. Use it only when `GET https://api.apihop.ai/v1/models` returns `deepseek-v4.1-flash` for your API Key. This reference entry does not confirm a production rollout or a successful inference test. Existing V4 Flash and V4 Pro IDs remain unchanged.

This positioning helps you choose an initial model to test; it is not a latency, throughput, or quality SLA. Compare available models with your own prompts, output lengths, and concurrency before production use.

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

The endpoint returns one complete Chat Completions response by default. The example includes `stream: false` explicitly so its behavior remains obvious when copied.

```json
{
  "model": "deepseek-v4-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a precise technical assistant."
    },
    {
      "role": "user",
      "content": "Explain three benefits of event-driven architecture."
    }
  ],
  "stream": false
}
```

To use the Pro model, change only the model field:

```json
{
  "model": "deepseek-v4-pro"
}
```

## Streaming Request

Set `stream: true` explicitly for streaming and process the response as SSE events until `[DONE]`.

```json
{
  "model": "deepseek-v4-pro",
  "messages": [
    {
      "role": "user",
      "content": "Create a checklist for a reversible database migration."
    }
  ],
  "stream": true
}
```

## Request Fields

### `model` (string, required)

Use `deepseek-v4-flash`, `deepseek-v4-pro`, or `deepseek-v4.1-flash`, as returned by `GET https://api.apihop.ai/v1/models`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

### `max_completion_tokens` (integer)

Optional compatibility alternative to `max_tokens`, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `stop`, and `n`. Support and semantic effects may vary by model; this guide does not establish V4.1 Flash support for every optional field.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. Services can remain loosely coupled..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 96,
    "total_tokens": 127
  }
}
```

Responses may contain additional usage details; treat them as optional.

## Usage Notes

- The current public contract is Chat Completions, including non-streaming and SSE streaming.
- These models are not currently available through OpenAI Responses or Claude Messages.
- Set the request body's `model` field to the exact ID: `deepseek-v4-flash`, `deepseek-v4-pro`, or `deepseek-v4.1-flash`.
- Use only model IDs returned by `GET https://api.apihop.ai/v1/models`.
- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

تستخدم نماذج DeepSeek نقطة نهاية Chat Completions المشتركة. لتبديل النموذج، غير قيمة model فقط؛ وتبقى نقطة النهاية والمصادقة كما هما.

text

POST https://api.apihop.ai/v1/chat-completions

النماذج المتاحة

قيمة `model`	التوجه	دون بث	بث SSE
`deepseek-v4-flash`	فئة Flash ونقطة بداية عملية للمحادثات الروتينية أو التقييمات الدفعية	نعم	نعم
`deepseek-v4-pro`	فئة Pro للتقييمات التي تعطي الأولوية للاستدلال المعقد وجودة الإخراج	نعم	نعم
`deepseek-v4.1-flash`	DeepSeek V4.1 Flash؛ معرف نموذج مستقل، وليس اسما بديلا لـV4 Flash	بعد النشر والتفعيل	بعد النشر والتفعيل

لا يصبح V4.1 Flash متاحا إلا بعد نشر إعداد التوجيه وتفعيله. استخدمه فقط عندما يعيد GET https://api.apihop.ai/v1/models القيمة deepseek-v4.1-flash لمفتاح API لديك. لا يؤكد هذا المدخل المرجعي طرحا في الإنتاج أو اختبار استدلال ناجحا. تبقى معرفات V4 Flash وV4 Pro القائمة دون تغيير.

يساعد هذا التوجه في اختيار نموذج أولي للاختبار؛ وليس اتفاقية مستوى خدمة لزمن الاستجابة أو معدل المعالجة أو الجودة. قارن النماذج المتاحة بتعليماتك وأطوال مخرجاتك ومستوى التزامن لديك قبل استخدامها في الإنتاج.

المصادقة

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

طلب دون بث

تعيد نقطة النهاية استجابة Chat Completions كاملة واحدة افتراضيا. يتضمن المثال stream: false صراحة كي يبقى سلوكه واضحا عند نسخه.

json

{
  "model": "deepseek-v4-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a precise technical assistant."
    },
    {
      "role": "user",
      "content": "Explain three benefits of event-driven architecture."
    }
  ],
  "stream": false
}

لاستخدام نموذج Pro، غير حقل النموذج فقط:

json

{
  "model": "deepseek-v4-pro"
}

طلب بث

اضبط stream: true صراحة للبث وعالج الاستجابة كأحداث SSE حتى [DONE].

json

{
  "model": "deepseek-v4-pro",
  "messages": [
    {
      "role": "user",
      "content": "Create a checklist for a reversible database migration."
    }
  ],
  "stream": true
}

حقول الطلب

modelstringمطلوب

استخدم deepseek-v4-flash أو deepseek-v4-pro أو deepseek-v4.1-flash كما يعيدها GET https://api.apihop.ai/v1/models.

messagesobject[]مطلوب

رسائل بأسلوب OpenAI Chat Completions. تتضمن كل رسالة role وcontent.

streambooleanالقيمة الافتراضية: false

تعيد true بث SSE؛ وتعيد false استجابة JSON كاملة واحدة.

max_tokensinteger

الحد الأقصى الاختياري لرموز الإخراج كعدد صحيح موجب. احذف هذا الحقل لاستخدام القيمة الافتراضية لدى المزود للنموذج المختار. بحسب النموذج، قد تشمل الميزانية رموز الاستدلال والنص النهائي معا. قد تقتطع الميزانية الصغيرة الإجابة أو تنفد قبل النص النهائي؛ وقد تزيد زيادتها التكلفة.

max_completion_tokensinteger

بديل توافق اختياري لـmax_tokens، مع اعتبارات الميزانية نفسها. يحدد النموذج المختار الدعم؛ واحذف الحقلين لاستخدام القيمة الافتراضية لدى المزود.

راجع واجهة Chat Completions المشتركة للحقول المشتركة مثل temperature وtop_p وfrequency_penalty وpresence_penalty وstop وn. قد يختلف الدعم والتأثير الدلالي بحسب النموذج؛ ولا يثبت هذا الدليل دعم V4.1 Flash لكل حقل اختياري.

استجابة ناجحة

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. Services can remain loosely coupled..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 96,
    "total_tokens": 127
  }
}

قد تتضمن الاستجابات تفاصيل استخدام إضافية؛ تعامل معها بوصفها اختيارية.

ملاحظات الاستخدام

العقد العام الحالي هو Chat Completions، بما فيه الوضع دون بث وبث SSE.
هذه النماذج غير متاحة حاليا عبر OpenAI Responses أو Claude Messages.
اضبط حقل model في جسم الطلب على المعرف الدقيق: deepseek-v4-flash أو deepseek-v4-pro أو deepseek-v4.1-flash.
استخدم فقط معرفات النماذج التي يعيدها GET https://api.apihop.ai/v1/models.
استخدم GET https://api.apihop.ai/v1/models للنماذج الظاهرة لمفتاح API الحالي، واستخدم وحدة التحكم للأسعار الحالية.