Cómo usar la API de DeepSeek V4 Pro en EvoLink: de la primera llamada a Claude Code

Qué vas a construir

1. una primera solicitud exitosa a V4 Pro en formato Anthropic Messages;
2. una configuración de Claude Code que corre sobre V4 Pro a través de EvoLink;
3. control correcto del modo thinking (y por qué budget_tokens no hace nada, en silencio);
4. manejo de los tres mapeos de parámetros que rompen las migraciones desde Claude;
5. una estrategia de 429/concurrencia y una ruta de respaldo para producción.

Requisitos previos

• Una cuenta de EvoLink y una clave de API creada en el dashboard.
• Cualquier cliente HTTP. Los ejemplos de abajo usan cURL y Python plano (requests) para que la forma de la solicitud quede explícita.
• El contrato completo de parámetros vive en la documentación de la Messages API de DeepSeek V4; esta guía se centra en el flujo y las trampas, no en duplicar la referencia.

Paso 1 — Tu primera solicitud a V4 Pro

curl https://direct.evolink.ai/v1/messages \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Refactor this function to be iterative: def f(n): return n*f(n-1) if n else 1"}
    ]
  }'

La misma llamada en Python, con dependencias mínimas:

import requests, os

resp = requests.post(
    "https://direct.evolink.ai/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['EVOLINK_API_KEY']}"},
    json={
        "model": "deepseek-v4-pro",
        "max_tokens": 1024,
        "messages": [{"role": "user", "content": "Summarize the tradeoffs of MoE routing in two sentences."}],
    },
    timeout=120,
)
resp.raise_for_status()
blocks = resp.json()["content"]
print(next(b["text"] for b in blocks if b["type"] == "text"))

Paso 2 — Cambia Claude Code a DeepSeek V4 Pro

Como EvoLink expone V4 Pro en un endpoint Messages compatible con Anthropic, Claude Code puede correr sobre él sobrescribiendo sus variables de entorno de endpoint:

export ANTHROPIC_BASE_URL="https://direct.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"
export ANTHROPIC_MODEL="deepseek-v4-pro"
claude

Ese es todo el cambio: tu flujo de trabajo de agente, tus herramientas y tus prompts quedan igual. Los reportes de la comunidad describen de forma consistente a V4 Pro como el más fuerte en tareas de programación largas y de múltiples pasos — el build 0813 prácticamente duplicó sus puntuaciones en benchmarks de agentes de terminal — así que un arnés agéntico como Claude Code es exactamente donde justifica su diferencia de precio frente a los modelos cerrados.

Dos notas prácticas para esta configuración:

• Las tool calls funcionan a través del flujo estándar de Anthropic tool_use / tool_result, así que las ediciones de archivos y las herramientas de shell de Claude Code operan con normalidad.
• V4 Pro no tiene entrada de visión. Las funciones de Claude Code que adjuntan capturas de pantalla o imágenes no funcionarán en esta ruta; mantén configurado un modelo con capacidad de visión para esas tareas.

Paso 3 — Las tres trampas de migración

Estos son los mapeos que difieren en silencio de la API nativa de Anthropic. Los tres provienen del contrato actual de EvoLink, verificado el 13 de agosto de 2026.

{
  "thinking": {"type": "enabled"},
  "output_config": {"effort": "high"}
}

{
  "model": "deepseek-v4-pro",
  "system": "You are a terse senior reviewer.",
  "messages": [{"role": "user", "content": "Review this diff..."}]
}

Paso 4 — El esfuerzo de thinking y lo que le hace a tu factura

DeepSeek factura los tokens de thinking como tokens de salida, y V4 Pro es un pensador intensivo: mediciones de la comunidad lo han mostrado consumiendo varias veces más tokens de razonamiento que sus pares de modelos cerrados en la misma tarea. Guía práctica:

• El valor por defecto es effort: "high" — un ajuste pesado para trabajo rutinario. Establece low de forma explícita en los pasos masivos, mantén high para las tareas donde un intento fallido cuesta más que los tokens extra, y deja max como nivel de escalado.
• La entrada con acierto de caché se factura a aproximadamente 1/120 de la tarifa sin acierto hasta el 16 de agosto de 2026 a las 16:00 UTC; después entra en vigor la nueva tarifa ya publicada por DeepSeek (precios duales pico/valle, con la ratio de caché de Pro pasando a aproximadamente 1/30). Las sesiones de agente largas con prompts de sistema estables siguen beneficiándose. Consulta las tarifas por token en vivo en los precios de los modelos DeepSeek en EvoLink en lugar de confiar en los números de ningún blog, incluidos los de este.
• Para pasos de alto volumen y baja dificultad (clasificación, resúmenes), enruta a deepseek-v4-flash y guarda Pro para los pasos difíciles.

Paso 5 — Concurrencia, 429 y respaldo

1. Trata el 429 como contrapresión: backoff exponencial con jitter, y mantén las solicitudes en vuelo por debajo de tu techo medido.
2. Configura timeouts de cliente generosos para tareas con esfuerzo high — el tiempo de thinking precede al primer token.
3. Configura un respaldo: como la ruta de EvoLink habla el mismo formato Messages para varios modelos, un fallback a nivel de router de deepseek-v4-pro a otro modelo disponible es un cambio de configuración, no una reescritura. Los hilos de la comunidad están llenos de exactamente este patrón — Flash para los pasos masivos, Pro para los pasos difíciles y un modelo cerrado como respaldo final.

FAQ

Próximos pasos

• Modelos DeepSeek en EvoLink — precios en vivo y acceso a los modelos.
• DeepSeek V4 Pro 0813: qué cambió — los cambios de agente y Codex del build GA.
• Guía de decisión Pro vs Flash — qué nivel encaja con qué carga de trabajo.