curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "deepseek-v4-flash",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'

{
  "id": "53ee6690-e14a-4e6b-890b-a135100d51c7",
  "type": "message",
  "role": "assistant",
  "model": "deepseek-v4-flash",
  "content": [
    {
      "type": "thinking",
      "thinking": "El usuario pregunta por la capital de Japón — una pregunta básica de geografía. La respuesta es Tokio, basta con darla directamente.",
      "signature": "53ee6690-e14a-4e6b-890b-a135100d51c7"
    },
    {
      "type": "text",
      "text": "La capital de Japón es **Tokio**."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 7,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 77,
    "service_tier": "standard"
  }
}

Messages API

DeepSeek V4 - API compatible con Anthropic

Llama al modelo DeepSeek V4 usando el protocolo Anthropic Messages
Modelos compatibles: deepseek-v4.1-flash-1017 / deepseek-v4.1-flash / deepseek-v4-flash / deepseek-v4-pro / deepseek-v4-flash-vision-exp
Estructura de solicitud / respuesta alineada con la API de Anthropic
Comprensión de imágenes: deepseek-v4.1-flash / deepseek-v4.1-flash-1017 / deepseek-v4-flash-vision-exp admite bloques de contenido image (source.type puede ser base64 o url)
Prompt de sistema: se pasa mediante el campo system de nivel superior
Modo de pensamiento: interruptor mediante el objeto thinking; el contenido de pensamiento se devuelve como block content[type=thinking]
Salida en streaming: flujo de eventos SSE
Llamada a herramientas: compatible con el flujo tool_use / tool_result de Anthropic

⚠️ Importante: enviar un bloque image a deepseek-v4-flash / deepseek-v4-pro no provoca un error, pero el proveedor sustituye la imagen por el marcador [Unsupported Image]. El modelo no ve la imagen y la solicitud se factura igualmente. Para comprender imágenes, establece siempre model en deepseek-v4.1-flash / deepseek-v4.1-flash-1017 / deepseek-v4-flash-vision-exp.

POST

messages

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "deepseek-v4-flash",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'

{
  "id": "53ee6690-e14a-4e6b-890b-a135100d51c7",
  "type": "message",
  "role": "assistant",
  "model": "deepseek-v4-flash",
  "content": [
    {
      "type": "thinking",
      "thinking": "El usuario pregunta por la capital de Japón — una pregunta básica de geografía. La respuesta es Tokio, basta con darla directamente.",
      "signature": "53ee6690-e14a-4e6b-890b-a135100d51c7"
    },
    {
      "type": "text",
      "text": "La capital de Japón es **Tokio**."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 7,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 77,
    "service_tier": "standard"
  }
}

BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.

Autorizaciones

Authorization

string

header

requerido

##Todas las interfaces requieren autenticación mediante Bearer Token##

Obtención de la API Key:

Visita la página de gestión de API Key para obtener tu API Key

Al usarla, añádela en la cabecera de la solicitud:

Authorization: Bearer YOUR_API_KEY

Nota: aunque la API nativa de Anthropic usa la cabecera x-api-key, EvoLink emplea de forma uniforme autenticación Bearer Token para /v1/messages.

Cuerpo

application/json

model

enum<string>

predeterminado:deepseek-v4-flash

requerido

Modelo a invocar

deepseek-v4.1-flash-1017: DeepSeek V4.1 Flash 1017 (última versión), con comprensión nativa de texto e imágenes, contexto de 1M y hasta 384K tokens de salida; respuestas más concisas y menor latencia que la versión anterior
deepseek-v4.1-flash: Versión anterior de DeepSeek V4.1 Flash, con las capacidades indicadas arriba; usa deepseek-v4.1-flash-1017 para la última versión
deepseek-v4-flash: rápido y general
deepseek-v4-pro: razonamiento profundo
deepseek-v4-flash-vision-exp: Nombre de modelo anterior, ahora redirigido a DeepSeek V4.1 Flash; usa deepseek-v4.1-flash para nuevas integraciones

Nota: todos los modelos tienen thinking habilitado por defecto y las respuestas siempre contienen un bloque de contenido type="thinking"; establece explícitamente thinking.type="disabled" para desactivarlo. Asignación automática de nombres de modelos Claude: puedes enviar directamente los nombres oficiales de modelos Anthropic. El proveedor asigna claude-opus-* a deepseek-v4-pro y claude-sonnet-* / claude-haiku-* a deepseek-v4-flash. Los nombres desconocidos fuera de la familia Claude (como gpt-4o) devuelven HTTP 400.

⚠️ Al conectar directamente herramientas como Claude Code sin cambiar el nombre del modelo, esta asignación determina el modelo que se ejecuta y se factura; opus se asigna a deepseek-v4-pro, cuyo precio es mayor.

La comprensión de imágenes requiere deepseek-v4.1-flash / deepseek-v4.1-flash-1017 / deepseek-v4-flash-vision-exp: los otros dos modelos no generan un error ante un bloque image, pero lo sustituyen por [Unsupported Image] y descartan la imagen real.

Opciones disponibles:

deepseek-v4-flash,

deepseek-v4-pro,

deepseek-v4-flash-vision-exp,

deepseek-v4.1-flash,

deepseek-v4.1-flash-1017

Ejemplo:

"deepseek-v4-flash"

max_tokens

integer

requerido

Número máximo de tokens a generar (obligatorio)

Descripción:

La serie V4 admite hasta 393,216
deepseek-v4.1-flash-1017 solo acepta de 1 a 393,216; los valores fuera de este rango devuelven HTTP 400
Los tokens producidos por thinking también cuentan para el límite de max_tokens

Rango requerido: 1 <= x <= 393216

Ejemplo:

1024

messages

object[]

requerido

Lista de mensajes de la conversación, alternando por turnos user / assistant

Descripción:

Debe contener al menos 1 mensaje
El último mensaje normalmente es role=user
Solo deepseek-v4.1-flash / deepseek-v4.1-flash-1017 / deepseek-v4-flash-vision-exp admite el tipo de contenido image; document no es compatible

Minimum array length: 1

Show child attributes

system

Prompt de sistema, se usa para definir el rol y el comportamiento de la IA

Descripción:

Admite cadena o array de cadenas
A diferencia del mensaje system del endpoint de OpenAI, el endpoint de Anthropic usa el campo system de nivel superior

Ejemplo:

"You are a helpful assistant."

temperature

number

predeterminado:1

Temperatura de muestreo

Descripción:

Rango [0.0, 2.0]
Por defecto 1; cuanto mayor el valor, más divergente; cuanto menor, más determinista

Rango requerido: 0 <= x <= 2

Ejemplo:

1

top_p

number

predeterminado:1

Umbral de muestreo por núcleo

Descripción:

Rango [0, 1]
Se recomienda no ajustar simultáneamente temperature y top_p

Rango requerido: 0 <= x <= 1

Ejemplo:

1

stop_sequences

string[]

Secuencias de parada personalizadas

Descripción:

El modelo detiene la generación al encontrar cualquiera de estas cadenas
Máximo 4 elementos (según la especificación de Anthropic)

Maximum array length: 4

stream

boolean

predeterminado:false

Si se devuelve en streaming SSE

true: devolución en streaming mediante Server-Sent Events
false: devuelve la respuesta completa de una vez (por defecto)

Ejemplo:

false

thinking

object

Control del modo de pensamiento (V4)

Descripción:

Habilitado por defecto en ambos modelos (type=enabled)
Al estar habilitado, el array content de la respuesta incluirá blocks type="thinking" con el proceso de razonamiento (facturados como tokens de salida)
Nota: esta API ignora el campo nativo de Anthropic budget_tokens; utiliza output_config.effort para controlar la profundidad
En multi-turno basta con devolver el thinking block de la respuesta anterior tal cual dentro del array content del mensaje assistant (el protocolo de Anthropic es más permisivo y no dará error si falta el thinking, pero mantener la signature ayuda a la coherencia contextual)

Show child attributes

output_config

object

Configuración de salida (extensión V4)

Descripción: Deepseek solo admite el campo effort

Show child attributes

tools

object[]

Lista de definiciones de herramientas

Descripción:

Sigue la especificación de definición de herramientas de Anthropic
input_schema utiliza un objeto JSON Schema

Show child attributes

tool_choice

object

Controla el comportamiento de llamada a herramientas

Valores posibles de type:

auto: el modelo decide automáticamente (por defecto cuando se proporcionan tools)
any: debe llamar a alguna herramienta (sin especificar cuál)
tool: debe llamar a la herramienta con el name especificado
none: prohíbe llamar a herramientas

Show child attributes

Respuesta

Objeto de mensaje

Respuesta de mensaje estilo Anthropic

string

ID único del mensaje

type

enum<string>

Tipo del objeto de respuesta

Opciones disponibles:

message

role

enum<string>

Opciones disponibles:

assistant

model

string

Modelo realmente utilizado

Ejemplo:

"deepseek-v4-pro"

content

object[]

Lista de bloques de contenido de la respuesta

Tipos de block posibles:

thinking: proceso de razonamiento (solo cuando thinking está habilitado)
text: texto de respuesta final
tool_use: llamada a herramienta iniciada por el modelo

Show child attributes

stop_reason

enum<string>

Motivo de parada

end_turn: final natural
max_tokens: alcanzado el límite de max_tokens
stop_sequence: se alcanzó una secuencia de stop_sequences
tool_use: el modelo activó una llamada a herramienta

Opciones disponibles:

end_turn,

max_tokens,

stop_sequence,

tool_use

stop_sequence

string | null

Secuencia concreta que se alcanzó cuando stop_reason=stop_sequence; de lo contrario null

usage

object

Estadísticas de uso de tokens (especificación de Anthropic)

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

DeepSeek V4 - API compatible con Anthropic

Autorizaciones

Cuerpo

Respuesta