Cómo usar DeepSeek a través de una API compatible con OpenAI
DeepSeek ya ofrece un endpoint al estilo de OpenAI. La cuestión práctica es dónde guardar la URL base, cómo gestionar los nombres de modelo y qué probar antes de mover el tráfico de producción.
Prueba Tokuse: crea una cuenta gratuita y envía tu primera petición a través de un único endpoint compatible con OpenAI.
Esta guía usa Tokuse como ejemplo de gateway porque su catálogo público de modelos incluye deepseek-flash y deepseek-v4-pro y expone una API compatible con OpenAI en:
https://tokuse.com/v1
El conjunto de modelos, las cuotas y el precio que se muestran para tu cuenta pueden cambiar. Consulta el catálogo actual antes del despliegue.
Qué significa ser compatible con OpenAI
La compatibilidad significa que los SDK de OpenAI existentes suelen poder enviar peticiones cambiando la URL base y el nombre del modelo. Tu aplicación puede mantener una estructura de cliente conocida:
SDK -> OpenAI-compatible base URL -> model alias -> provider
El gateway recibe la petición, resuelve el modelo, adjunta la credencial del proveedor y devuelve una respuesta normalizada. Así los cambios de proveedor quedan fuera del código del producto.
La compatibilidad no significa que todos los parámetros específicos de cada proveedor funcionen igual. Prueba streaming, llamadas a herramientas, salida JSON, códigos de error y contabilidad de tokens con el SDK y el modelo exactos que piensas usar.
Configuración de Python
Instala el SDK de OpenAI:
pip install openai
Configura la clave de Tokuse en el servidor:
export TOKUSE_API_KEY="YOUR_KEY"
Después usa la interfaz habitual de chat completions:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKUSE_API_KEY"],
base_url="https://tokuse.com/v1",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{
"role": "system",
"content": "Return a compact JSON object. Do not add commentary.",
},
{
"role": "user",
"content": "Extract the company name and plan from: Acme Pro, billed monthly.",
},
],
response_format={"type": "json_object"},
max_tokens=200,
)
print(response.choices[0].message.content)
Usa la URL base sin /chat/completions. El SDK añade la ruta del endpoint por sí mismo.
Configuración de Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKUSE_API_KEY,
baseURL: "https://tokuse.com/v1",
});
const response = await client.chat.completions.create({
model: "deepseek-flash",
messages: [
{
role: "user",
content: "Summarize this support ticket in one sentence.",
},
],
max_tokens: 120,
});
console.log(response.choices[0].message.content);
Mantén la clave en variables de entorno del lado del servidor. No la expongas en bundles de navegador, apps móviles ni registros de compilación.
Elige el modelo según la tarea
Usa deepseek-flash primero para extracción rutinaria, clasificación, resúmenes y pasos de flujo de trabajo de alto volumen. Prueba deepseek-v4-pro en tareas de razonamiento complejo o de horizonte largo donde la ruta más barata no supere tu evaluación.
La decisión de enrutamiento debe basarse en completar la tarea con éxito, no en el prestigio del modelo. Compara calidad, longitud de salida, latencia, reintentos y coste por tarea exitosa.
El precio de cache hit de DeepSeek hace que los prompts estables sean especialmente importantes. Su tarifa oficial fuera de horas punta es de $0.003/M en cache hit frente a $0.15/M en cache miss; en Tokuse, las tarifas base actuales de deepseek-flash son $0.274/M de entrada y $1.096/M de salida, con cache hits alrededor de $0.006/M. Consulta el modelo completo de precios y caché de DeepSeek antes de elegir un presupuesto.
Prueba estos modos de fallo
401 o token no válido
Confirma que la clave pertenece a la cuenta del gateway y que no tiene espacios accidentales. Rota la clave si alguna vez se ha incluido en un commit o en un registro.
404 en chat completions
Comprueba tanto la URL base como la ruta del SDK. https://tokuse.com/v1 es la URL base. No añadas la ruta /chat/completions del SDK salvo que tu cliente HTTP espere un endpoint completo.
Modelo no compatible
Consulta el catálogo de modelos actual o el panel. Los alias de modelo pueden variar según la cuenta y la disponibilidad. Un modelo que funcionaba durante el piloto puede desactivarse más adelante.
429 o errores de cuota
Añade retroceso exponencial acotado con jitter. No reintentes indefinidamente. Distingue los límites por minuto de los errores de saldo o cuota de la cuenta.
Salida truncada
Revisa finish_reason, el límite de tokens de salida y el esquema solicitado. Un límite mayor puede aumentar el coste sin mejorar el resultado. Mide ambos.
Fallos de streaming
Registra la latencia del primer token y el punto de fallo. Una vez que los tokens han llegado al usuario, un reintento transparente puede duplicar texto. Prefiere un error visible o una continuación controlada.
Lista de comprobación para producción
- Usa claves distintas para desarrollo y producción.
- Nunca incluyas claves de proveedor o de gateway en el código cliente.
- Registra IDs de petición, modelo, estado, latencia, tokens de entrada, tokens de salida y número de reintentos.
- Oculta prompts, respuestas y cabeceras de autorización de los registros por defecto.
- Fija los alias de modelo y prueba los cambios antes del despliegue.
- Añade tiempos de espera, presupuestos de reintentos y un interruptor de emergencia.
- Compara el coste por tarea exitosa, no el coste por petición.
- Empieza con un porcentaje pequeño del tráfico y mide la calidad con un conjunto de evaluación fijo.
Empieza con un solo endpoint
Tokuse ofrece un endpoint compatible con OpenAI, un catálogo de modelos, gestión de uso y un panel de administración para equipos que evalúan varios modelos de IA. Empieza con el catálogo actual y una clave de prueba, y luego pasa una carga de trabajo de bajo riesgo por el gateway antes de ampliar.
Crea una cuenta de Tokuse e inspecciona los modelos actuales
Guías relacionadas de costes y migración
- Precios de DeepSeek y modelo de coste de cache hit
- Experimento de precios de DeepSeek en horas punta y valle
- Calculadora de costes de DeepSeek
- Referencia de la API Chat Completions