Familia DeepSeek

Los modelos de la serie V4 de DeepSeek, que incluyen V4.1 Flash, V4 Pro y V4 Flash. Se llaman a través de la API compatible con OpenAI y también admiten el endpoint nativo de Anthropic, por lo que pueden usarse directamente en herramientas como Claude Code.

Tareas habituales

Modelos

La serie V4 tiene un contexto de 1M tokens y una salida máxima de 384K tokens. V4.1 Flash admite entrada de imágenes; el resto de modelos solo admite texto. La lista completa de modelos y los precios en tiempo real están en la página de modelos .

Alias y versiones

• Los alias se usan sin el prefijo deepseek/, por ejemplo "model": "deepseek-v4-pro"; escribir deepseek/deepseek-v4-pro devuelve 404.
• deepseek-chat y deepseek-reasoner de la API oficial de DeepSeek no están disponibles en OfoxAI; use los IDs de modelo de la tabla anterior.
• Las versiones anteriores deepseek/deepseek-v4-pro-0423 y deepseek/deepseek-v4-flash-0423 siguen disponibles, pero el thinking se activa de forma distinta que en las versiones nuevas; consulte Modo thinking.

Ejemplos de llamada

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "Explica en una frase qué es la idempotencia."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "Explica en una frase qué es la idempotencia."}],
    "thinking": {"type": "disabled"}
  }'

Modo thinking

En nuestras mediciones con un mismo problema matemático, V4 Pro pensó por defecto unos 12.000 tokens y tardó unos 2 minutos; con el thinking desactivado, unos 20 segundos. Los tokens de thinking se facturan al precio de salida; su número figura en usage.completion_tokens_details.reasoning_tokens.

Leer el contenido del thinking

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "¿Cuánto es 17 × 23?"}],
)
msg = resp.choices[0].message
details = getattr(msg, "reasoning_details", None) or []
print("[Thinking]", "".join(d.get("text", "") for d in details))
print("[Respuesta]", msg.content)

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "¿Cuánto es 17 × 23?"}],
    stream=True,
)
for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)

• En las respuestas sin streaming, el contenido del thinking está en message.reasoning_details; concatene por orden el text de cada elemento.
• En las respuestas en streaming, el contenido del thinking está en delta.reasoning_content, igual que en la API oficial de DeepSeek.
• En conversaciones de varios turnos, no es necesario devolver el contenido del thinking en los mensajes del historial.

Uso en Claude Code

La serie DeepSeek V4 admite el endpoint nativo de Anthropic, con la URL https://api.ofox.io/anthropic, por lo que puede usarse en Claude Code y otras herramientas basadas en el protocolo de Anthropic:

curl https://api.ofox.io/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "max_tokens": 4000,
    "thinking": {"type": "disabled"},
    "messages": [{"role": "user", "content": "Explica en una frase qué es la idempotencia."}]
  }'

• Al llamar a través del endpoint de Anthropic, el contenido del thinking se devuelve en bloques thinking, y "thinking": {"type": "disabled"} también desactiva el thinking.
• Con el thinking activado, configure un max_tokens suficientemente grande. Si el límite no basta, la respuesta puede contener solo el bloque thinking sin respuesta.

Los pasos completos de configuración de Claude Code están en Configuración de Claude Code.

Salida JSON y llamadas a herramientas

response_format admite {"type": "json_object"} y {"type": "json_schema", ...}; las llamadas a herramientas usan el parámetro estándar tools:

import json
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro-0813",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "Devuelve price y currency en JSON: un bate y una pelota cuestan 1,10 dólares en total. El bate cuesta 1 dólar más que la pelota. ¿Cuánto cuesta la pelota?"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(json.loads(resp.choices[0].message.content))

Al usar json_object, indique en el prompt «devuelve en JSON» y los campos que necesita.

Caché de prompts

DeepSeek almacena en caché automáticamente los prefijos de petición repetidos, sin cambiar la petición. La cantidad acertada figura en usage.prompt_tokens_details.cached_tokens, y la parte acertada se factura al precio de lectura de caché. La caché funciona según el principio de mejor esfuerzo; incluso peticiones con el mismo prefijo pueden no acertar.

Proveedores

Cómo seleccionar un proveedor: Enrutamiento de proveedores.

Errores habituales

Otros errores generales: Gestión de errores.

Documentación oficial

• Documentación de la API de DeepSeek 
• DeepSeek · Modo thinking 
• DeepSeek · Compatibilidad con la API de Anthropic 

La documentación oficial describe el comportamiento al llamar directamente a DeepSeek. Al llamar a través de OfoxAI, los IDs de modelo y las URL de los endpoints son los de esta página.

Preguntas frecuentes