Modèles DeepSeek | Documentation des 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)

Les modèles DeepSeek utilisent l’endpoint Chat Completions commun. Pour changer de modèle, modifiez uniquement la valeur de model ; l’endpoint et l’authentification restent identiques.

text

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

Modèles disponibles

Valeur de `model`	Positionnement	Sans streaming	Streaming SSE
`deepseek-v4-flash`	Niveau Flash et point de départ pratique pour le chat courant ou les évaluations par lots	Oui	Oui
`deepseek-v4-pro`	Niveau Pro pour les évaluations privilégiant le raisonnement complexe et la qualité de sortie	Oui	Oui
`deepseek-v4.1-flash`	DeepSeek V4.1 Flash ; ID de modèle distinct, pas un alias de V4 Flash	Après déploiement et activation	Après déploiement et activation

V4.1 Flash devient disponible uniquement après le déploiement et l’activation de sa configuration de routage. Utilisez-le seulement si GET https://api.apihop.ai/v1/models renvoie deepseek-v4.1-flash pour votre clé API. Cette référence ne confirme ni déploiement en production ni test d’inférence réussi. Les ID existants de V4 Flash et V4 Pro restent inchangés.

Ce positionnement aide à choisir un premier modèle à tester ; ce n’est pas un SLA de latence, de débit ou de qualité. Comparez les modèles disponibles avec vos propres consignes, longueurs de sortie et niveaux de concurrence avant la production.

Authentification

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Requête sans streaming

L’endpoint renvoie par défaut une réponse Chat Completions complète. L’exemple inclut explicitement stream: false pour que son comportement reste clair après copie.

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
}

Pour utiliser le modèle Pro, changez uniquement le champ du modèle :

json

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

Requête avec streaming

Définissez explicitement stream: true pour le streaming et traitez la réponse sous forme d’événements SSE jusqu’à [DONE].

json

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

Champs de requête

modelstringobligatoire

Utilisez deepseek-v4-flash, deepseek-v4-pro ou deepseek-v4.1-flash, selon les résultats de GET https://api.apihop.ai/v1/models.

messagesobject[]obligatoire

Messages au format OpenAI Chat Completions. Chaque message contient role et content.

streambooleanPar défaut: false

true renvoie SSE ; false renvoie une réponse JSON complète.

max_tokensinteger

Nombre maximal facultatif de tokens de sortie, sous forme d’entier positif. Omettez ce champ pour utiliser la valeur par défaut du fournisseur pour le modèle choisi. Selon le modèle, ce budget peut inclure les tokens de raisonnement et le texte final. Un petit budget peut tronquer la réponse ou être épuisé avant le texte final ; l’augmenter peut accroître le coût.

max_completion_tokensinteger

Alternative de compatibilité facultative à max_tokens, avec les mêmes considérations de budget. Le modèle choisi détermine sa prise en charge ; omettez les deux champs pour utiliser la valeur par défaut du fournisseur.

Consultez Chat Completions commun pour les champs partagés tels que temperature, top_p, frequency_penalty, presence_penalty, stop et n. La prise en charge et les effets sémantiques peuvent varier selon le modèle ; ce guide ne confirme pas la prise en charge de chaque champ optionnel par V4.1 Flash.

Réponse réussie

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

Les réponses peuvent contenir des détails d’utilisation supplémentaires ; considérez-les comme facultatifs.

Notes d’utilisation

Le contrat public actuel est Chat Completions, sans streaming et avec streaming SSE.
Ces modèles ne sont actuellement pas disponibles via OpenAI Responses ou Claude Messages.
Définissez le champ model du corps de requête avec l’ID exact : deepseek-v4-flash, deepseek-v4-pro ou deepseek-v4.1-flash.
Utilisez uniquement les ID de modèles renvoyés par GET https://api.apihop.ai/v1/models.
Utilisez GET https://api.apihop.ai/v1/models pour les modèles visibles par la clé API actuelle et la console pour les tarifs actuels.