Herramientasopenrouter
OpenRouter DeepSeek: conecta la API paso a paso
Conecta DeepSeek en OpenRouter con una primera llamada, compara proveedores y aprende a controlar costes, claves y datos antes de usarlo en tu trabajo.
- Autor: humAIns
- 9 min de lectura
índice · 6 apartados
Para usar un modelo DeepSeek mediante OpenRouter necesitas una clave de OpenRouter, el identificador vigente del modelo y una petición HTTP al endpoint de OpenRouter. El servicio actúa como intermediario y selecciona un proveedor de inferencia según la configuración disponible; no es lo mismo que llamar directamente a la API de DeepSeek. Esta guía hace una primera llamada con texto ficticio y explica qué revisar antes de llevarla a un flujo de trabajo.
Qué cambia entre OpenRouter y la API directa de DeepSeek
La API directa de DeepSeek envía la petición a https://api.deepseek.com y requiere una clave creada en la plataforma de DeepSeek. Su documentación actual presenta, entre otros elementos, los nombres deepseek-flash y deepseek-v4-pro. Para empezar por esa vía, sigue nuestra guía de API de DeepSeek: precio, clave y primeros pasos.
OpenRouter ofrece un endpoint propio compatible con formatos de API habituales y un catálogo donde aparecen modelos de DeepSeek con identificadores específicos, por ejemplo deepseek/deepseek-v4.1-flash-1017. La clave de OpenRouter autentica esa petición y la plataforma la encamina a un proveedor disponible. El identificador no tiene por qué coincidir con el nombre usado en la API directa. Comprueba el modelo que quieras utilizar en la página de DeepSeek en OpenRouter y su ficha, ya que catálogo y precios pueden cambiar.
| Aspecto | OpenRouter | API directa de DeepSeek |
|---|---|---|
| Dirección de la solicitud | https://openrouter.ai/api/v1/chat/completions | https://api.deepseek.com/chat/completions |
| Credencial de la ruta estándar | Clave de OpenRouter | Clave de DeepSeek |
| Selección | Modelo del catálogo y, si se desea, preferencias de proveedor | Modelos e identificadores admitidos en la plataforma de DeepSeek |
| A quién revisar | Condiciones de OpenRouter y del proveedor seleccionado | Condiciones de DeepSeek |
La ventaja práctica de OpenRouter es centralizar el acceso a modelos de distintos proveedores con una interfaz común. A cambio, hay una capa adicional entre tu aplicación y quien ejecuta el modelo: es importante entender las reglas de encaminamiento, tratamiento de datos, precio y disponibilidad. La ficha de DeepSeek V3 y sus modelos aporta contexto sobre generaciones, pero no sustituye la comprobación del identificador que ofrece hoy cada API.
Requisitos, cuenta y clave sin exponer secretos
- Crea o inicia sesión en tu cuenta de OpenRouter desde su web oficial.
- Genera una clave API desde el panel de la cuenta. Copia el secreto una sola vez a un gestor de contraseñas o al gestor de secretos aprobado por tu equipo.
- Revisa el catálogo y elige una ficha de DeepSeek que esté disponible para tu cuenta. Anota el identificador literal que muestra la ficha: no copies un nombre de una guía antigua.
- Ejecuta la prueba desde tu terminal o un servidor privado, nunca desde código JavaScript que se entregue al navegador.
En macOS o Linux puedes guardar la clave en una variable de entorno de la sesión. Sustituye el marcador por el secreto solo en tu propio terminal; este ejemplo no contiene una clave real:
export OPENROUTER_API_KEY="<tu_clave_guardada_localmente>"
No subas el valor a Git, a un notebook compartido, a un ticket ni a un registro de errores. Añade los ficheros locales de configuración a las exclusiones del repositorio y restringe quién puede leer los secretos de producción. Si una clave se filtra, revócala en el panel y crea otra. Nunca pegues credenciales en un formulario de chat para pedir que alguien ejecute la llamada.
Primera llamada paso a paso
El siguiente ejemplo usa Chat Completions, una ruta documentada por OpenRouter, y envía únicamente texto inventado. Antes de usarlo, confirma en la ficha que deepseek/deepseek-v4.1-flash-1017 sigue disponible para tu cuenta; los slugs pueden cambiar. La solicitud y respuesta no contienen datos de clientes ni secretos:
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4.1-flash-1017",
"messages": [
{"role": "user", "content": "Redacta un asunto ficticio para una reunión de planificación."}
]
}'
La petición autentica con el encabezado Authorization, declara JSON y solicita el modelo seleccionado. Una respuesta correcta suele incluir opciones de salida y datos de uso; consulta el campo de contenido de la primera opción para leer el texto generado. Guarda también el identificador de solicitud si necesitas investigar un error, pero no registres la clave ni contenido confidencial.
Si recibes un error, comprueba en este orden:
- 401 o 403: variable vacía, clave revocada o permisos/cuenta incorrectos. Verifica que la variable existe sin imprimir su valor y crea una clave nueva si hace falta.
- Modelo no disponible: vuelve a copiar el slug de la ficha actual. Revisa si la ficha requiere acceso o si el proveedor admite ese modelo.
- Límite o saldo: consulta el panel de actividad, saldo y límites configurados. Un error de capacidad temporal no significa necesariamente que el identificador sea incorrecto.
- Parámetro incompatible: quita parámetros opcionales y prueba la solicitud mínima. Los proveedores no siempre implementan las mismas opciones.
- Respuesta inesperada o lenta: identifica modelo, proveedor, hora e ID de solicitud y revisa los registros. Repite solo con texto de prueba, sin exponer información privada.
Elegir variante, proveedor y coste
Empieza por la tarea, no por el nombre más llamativo. Una variante rápida puede bastar para clasificar mensajes o preparar un borrador; razonamiento más complejo puede justificar evaluar otra versión. Haz una prueba representativa con ejemplos ficticios y una rúbrica: exactitud, formato, latencia y revisión necesaria. No deduzcas calidad profesional a partir del nombre o de la ficha comercial.
La lista oficial de modelos DeepSeek en OpenRouter y la ficha de cada modelo muestran disponibilidad y precios por tokens de entrada y salida; los proveedores pueden tener tarifas distintas. El precio publicado no es una cotización estable: compruébalo justo antes de presupuestar y vuelve a hacerlo al desplegar. No reutilices en una estimación cifras copiadas de un artículo antiguo.
OpenRouter puede elegir proveedor según variables como precio efectivo, rendimiento, latencia y fiabilidad. La configuración provider permite, entre otras opciones, ordenar proveedores, restringir la lista o indicar si se admiten alternativas. Si fijas un proveedor, puedes reducir la flexibilidad ante una caída o un límite; si dejas el enrutamiento abierto, revisa qué proveedor sirvió la petición en los registros. Valora además las diferencias de soporte de parámetros y disponibilidad que muestra la ficha.
Para ver el coste de una petición, registra su identificador y consulta los registros o actividad de tu cuenta. Contrasta el modelo, proveedor y tokens de entrada/salida con la ficha vigente. Las instrucciones de sistema largas, historiales completos y respuestas extensas aumentan el consumo; limita el contexto, pide una longitud razonable y evita reintentos automáticos ilimitados. Si tu aplicación ejecuta lotes, añade un presupuesto de prueba y alertas antes de aumentar el tráfico.
Privacidad, límites de gasto y diagnóstico
Una llamada por API implica enviar el contenido al servicio y al proveedor que la procesa. OpenRouter describe controles de privacidad y opciones de proveedor, pero eso no convierte cualquier solicitud en apta para datos personales. Su documentación distingue los registros de contenido de metadatos operativos y explica que las reglas de retención dependen de ajustes y del proveedor. Comprueba las condiciones actuales para cada ruta y la política de tu organización antes de usar información real.
Para una demostración, usa casos inventados. En un flujo profesional, minimiza el texto, elimina identificadores y no envíes contratos, datos de clientes o información interna a una cuenta no aprobada. Revisa nuestra guía de privacidad de IA en el trabajo y aplica las reglas de seguridad y protección de datos de tu organización. Un ajuste técnico de retención no sustituye la evaluación de base jurídica, contrato y transferencias que corresponda.
En el panel de OpenRouter puedes revisar privacidad y uso. La configuración por solicitud admite restricciones de proveedor y controles relacionados con datos cuando los proveedores los soportan; una opción no debe interpretarse como garantía universal para todos los modelos. Para equipos, valora claves separadas por aplicación, topes de gasto y listas permitidas de modelos. Comprueba qué límite se aplica a cada clave y si alcanza también a solicitudes hechas con claves de proveedor propias.
Antes de pasar a producción, deja una lista de comprobación:
- ¿El modelo y el proveedor están aprobados para la tarea y el tipo de dato?
- ¿La clave vive en el servidor, fuera del código y de los registros?
- ¿Hay un límite de gasto, alertas y control de reintentos?
- ¿Puedes identificar el proveedor y el coste de cada petición?
- ¿Hay una alternativa manual si el servicio no responde?
OpenRouter sirve para probar varios modelos desde una integración común, pero no elimina la responsabilidad de revisar los datos que envías ni el consumo que generas. Si formas parte de un equipo de marketing que está diseñando flujos profesionales, consulta el curso de IA para marketing; su ficha describe el programa y no implica que enseñe esta API concreta.
Preguntas frecuentes
¿Necesito una clave de DeepSeek además de la de OpenRouter?
No para la ruta estándar de modelos alojados en el catálogo: la petición se autoriza con una clave de OpenRouter. Solo necesitarías configurar credenciales propias si eliges explícitamente una modalidad de conexión con clave de proveedor (BYOK); confirma los pasos y condiciones en la documentación vigente.
¿Es gratis usar DeepSeek en OpenRouter?
No debe asumirse. Consulta la ficha del modelo y los términos de tu cuenta: precio, disponibilidad y condiciones pueden variar por versión, proveedor o promoción. Una opción o crédito promocional no demuestra que el uso posterior sea gratuito.
¿Cómo elijo el modelo y el proveedor?
Primero confirma el slug actual en el catálogo. Después decide si quieres que OpenRouter gestione el encaminamiento o restringir proveedores con las opciones admitidas por la petición. Compara disponibilidad, coste, latencia, capacidades y reglas de datos; prueba con casos ficticios antes de integrar.
¿Dónde veo el coste de una petición?
Busca la solicitud en la actividad o registros de tu cuenta y comprueba tokens, modelo, proveedor e importe. Las pantallas pueden cambiar; contrasta el desglose con los precios actuales de la ficha, no con capturas o tarifas antiguas.
Sigue leyendo en humAIns