Modelos DeepSeek | Documentación de 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)

Los modelos DeepSeek usan el endpoint Chat Completions común. Para cambiar de modelo, cambia solo el valor de model; el endpoint y la autenticación siguen siendo los mismos.

text

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

Modelos disponibles

Valor de `model`	Posicionamiento	Sin streaming	Streaming SSE
`deepseek-v4-flash`	Nivel Flash y punto de partida práctico para chat habitual o evaluaciones por lotes	Sí	Sí
`deepseek-v4-pro`	Nivel Pro para evaluaciones que priorizan razonamiento complejo y calidad de salida	Sí	Sí
`deepseek-v4.1-flash`	DeepSeek V4.1 Flash; ID de modelo distinto, no un alias de V4 Flash	Tras desplegar y activar	Tras desplegar y activar

V4.1 Flash solo está disponible después de desplegar y activar su configuración de enrutamiento. Úsalo únicamente cuando GET https://api.apihop.ai/v1/models devuelva deepseek-v4.1-flash para tu clave de API. Esta referencia no confirma un despliegue en producción ni una prueba de inferencia correcta. Los ID existentes de V4 Flash y V4 Pro no cambian.

Este posicionamiento ayuda a elegir un modelo inicial para probar; no es un SLA de latencia, rendimiento o calidad. Compara los modelos disponibles con tus propias instrucciones, longitudes de salida y concurrencia antes de usarlos en producción.

Autenticación

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Solicitud sin streaming

El endpoint devuelve una respuesta completa de Chat Completions de forma predeterminada. El ejemplo incluye stream: false explícitamente para que el comportamiento siga siendo claro al copiarlo.

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
}

Para usar el modelo Pro, cambia solo el campo del modelo:

json

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

Solicitud con streaming

Establece stream: true explícitamente para streaming y procesa la respuesta como eventos SSE hasta [DONE].

json

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

Campos de solicitud

modelstringobligatorio

Usa deepseek-v4-flash, deepseek-v4-pro o deepseek-v4.1-flash, según devuelva GET https://api.apihop.ai/v1/models.

messagesobject[]obligatorio

Mensajes al estilo OpenAI Chat Completions. Cada mensaje contiene role y content.

streambooleanPredeterminado: false

true devuelve SSE; false devuelve una respuesta JSON completa.

max_tokensinteger

Máximo opcional de tokens de salida, como entero positivo. Omite este campo para usar el valor predeterminado del proveedor para el modelo elegido. Según el modelo, el límite puede incluir tokens de razonamiento y texto final. Un límite pequeño puede truncar la respuesta o agotarse antes del texto final; aumentarlo puede incrementar el coste.

max_completion_tokensinteger

Alternativa opcional de compatibilidad a max_tokens, con las mismas consideraciones sobre el límite. El modelo elegido determina la compatibilidad; omite ambos campos para usar el valor predeterminado del proveedor.

Consulta Chat Completions común para campos compartidos como temperature, top_p, frequency_penalty, presence_penalty, stop y n. La compatibilidad y los efectos semánticos pueden variar según el modelo; esta guía no establece que V4.1 Flash admita todos los campos opcionales.

Respuesta correcta

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

Las respuestas pueden incluir detalles adicionales de uso; trátalos como opcionales.

Notas de uso

El contrato público actual es Chat Completions, tanto sin streaming como con streaming SSE.
Estos modelos no están disponibles actualmente mediante OpenAI Responses ni Claude Messages.
Establece el campo model del cuerpo de solicitud con el ID exacto: deepseek-v4-flash, deepseek-v4-pro o deepseek-v4.1-flash.
Usa solo los ID de modelos devueltos por GET https://api.apihop.ai/v1/models.
Usa GET https://api.apihop.ai/v1/models para consultar los modelos visibles para la clave actual y la consola para los precios vigentes.