DeepSeek modelleri | API Belgeleri

# 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 modelleri ortak Chat Completions uç noktasını kullanır. Model değiştirmek için yalnızca model değerini değiştirin; uç nokta ve kimlik doğrulama aynı kalır.

text

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

Kullanılabilir modeller

`model` değeri	Konumlandırma	Akışsız	SSE akışı
`deepseek-v4-flash`	Flash seviyesi; günlük sohbet veya toplu değerlendirmeler için pratik başlangıç	Evet	Evet
`deepseek-v4-pro`	Karmaşık akıl yürütme ve çıktı kalitesine öncelik veren değerlendirmeler için Pro seviyesi	Evet	Evet
`deepseek-v4.1-flash`	DeepSeek V4.1 Flash; V4 Flash takma adı değil, ayrı model ID’si	Dağıtım ve etkinleştirme sonrası	Dağıtım ve etkinleştirme sonrası

V4.1 Flash yalnızca yönlendirme ayarı dağıtılıp etkinleştirildikten sonra kullanılabilir. Sadece GET https://api.apihop.ai/v1/models anahtarınız için deepseek-v4.1-flash döndürüyorsa kullanın. Bu kayıt üretim dağıtımını veya başarılı çıkarım testini doğrulamaz. Mevcut V4 Flash ve V4 Pro ID’leri değişmez.

Bu konumlandırma ilk test modelini seçmeye yardımcı olur; gecikme, iş hacmi veya kalite SLA’sı değildir. Üretimden önce kendi istemleriniz, çıktı uzunluklarınız ve eşzamanlılığınızla modelleri karşılaştırın.

Kimlik doğrulama

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Akışsız istek

Uç nokta varsayılan olarak tek bir tam Chat Completions yanıtı döndürür. Örnekte stream: false açıkça vardır; böylece kopyalandığında da davranış bellidir.

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 modelini kullanmak için yalnızca model alanını değiştirin:

json

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

Akış isteği

Akış için stream: true değerini açıkça ayarlayın ve yanıtı [DONE] gelene kadar SSE olayları olarak işleyin.

json

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

İstek alanları

modelstringzorunlu

GET https://api.apihop.ai/v1/models tarafından döndürülen deepseek-v4-flash veya deepseek-v4-pro veya deepseek-v4.1-flash kullanın.

messagesobject[]zorunlu

OpenAI Chat Completions tarzı mesajlar. Her mesaj role ve content içerir.

streambooleanVarsayılan: false

true SSE döndürür; false tek bir tam JSON yanıtı döndürür.

max_tokensinteger

Pozitif tamsayı olarak isteğe bağlı azami çıktı tokenı. Seçilen modelin üst sağlayıcı varsayılanını kullanmak için atlayın. Modele göre bütçe, akıl yürütme tokenlarını ve son metni kapsayabilir. Küçük bütçe yanıtı kesebilir veya son metinden önce tükenebilir; artırmak maliyeti yükseltebilir.

max_completion_tokensinteger

Aynı bütçe hususlarıyla max_tokens için isteğe bağlı uyumluluk alternatifi. Desteği seçilen model belirler; üst varsayılanı kullanmak için iki alanı da atlayın.

temperature, top_p, frequency_penalty, presence_penalty, stop ve n gibi ortak alanlar için Ortak Chat Completions belgesine bakın. Destek ve anlamsal etkiler modele göre değişebilir; bu kılavuz V4.1 Flash’ın tüm isteğe bağlı alanları desteklediğini belirtmez.

Başarılı yanıt

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
  }
}

Yanıtlar ek kullanım ayrıntıları içerebilir; bunları isteğe bağlı kabul edin.

Kullanım notları

Güncel açık sözleşme, akışsız ve SSE akışlı Chat Completions’tır.
Bu modeller şu anda OpenAI Responses veya Claude Messages üzerinden kullanılamaz.
Gövdenin model alanını tam ID’ye ayarlayın: deepseek-v4-flash, deepseek-v4-pro veya deepseek-v4.1-flash.
Yalnızca GET https://api.apihop.ai/v1/models tarafından döndürülen ID’leri kullanın.
Mevcut anahtara görünen modeller için GET https://api.apihop.ai/v1/models, güncel fiyatlar için konsolu kullanın.