Cómo obtener tu API key de DeepSeek paso a paso

Una DeepSeek API key es la credencial que autentica tus peticiones contra la API de DeepSeek y te permite integrar modelos como DeepSeek V4 Flash o DeepSeek V4 Pro en tu código. Si quieres automatizar tareas, crear asistentes, conectar herramientas o probar la API desde cURL, Python o Node.js, este es el primer paso que debes completar de forma correcta y segura.[1][2]

Resumen rápido

• La DeepSeek API key se crea desde la plataforma de DeepSeek, dentro del panel de claves de API.[2]
• La API usa autenticación Bearer y es compatible con el formato de OpenAI; la base principal es https://api.deepseek.com y el endpoint compatible indicado por la documentación es /v1/ para clientes OpenAI compatibles.[1][2]
• En mayo de 2026, DeepSeek V4 Flash cuesta $0,14 por 1M tokens de entrada y $0,28 por 1M tokens de salida; DeepSeek V4 Pro cuesta $1,74 de entrada y $3,48 de salida.[1]
• Los alias deepseek-chat y deepseek-reasoner seguirán funcionando solo de forma temporal y se deprecarán el 24 de julio de 2026.[1][3]
• La forma más segura de usar tu clave es guardarla en variables de entorno, nunca dentro del repositorio ni en el código fuente versionado.[2]
• DeepSeek V4 ofrece hasta 1M tokens de contexto y un máximo de 384K tokens de salida; V4 Pro añade un modo de razonamiento más alto, thinking-max.[1]

Qué necesitas antes de crear tu clave

Antes de generar una DeepSeek API key, conviene preparar tres cosas: una cuenta activa en la plataforma, un método claro para guardar secretos y una idea básica del modelo que vas a usar. La parte técnica es sencilla, pero este orden evita errores al empezar.

La documentación oficial de DeepSeek indica que primero debes crear una API key y después autenticar tus peticiones con Bearer Auth.[2] También confirma que la API es compatible con el formato de OpenAI y que los modelos actuales de referencia son deepseek-v4-flash y deepseek-v4-pro.[1][2]

• Una cuenta en platform.deepseek.com.
• Acceso al panel de API y, si procede, saldo disponible en la cuenta.
• Un gestor de secretos, archivo .env local o variables de entorno del sistema.
• Un cliente para probar la clave: cURL, Python o Node.js.

Si todavía no tienes claro qué modelo usar, una referencia rápida ayuda. DeepSeek V4 Flash está orientado a coste bajo y latencia contenida, mientras que DeepSeek V4 Pro sube precio y capacidad de razonamiento. Puedes revisar también la tabla de precios de DeepSeek y la guía de API para elegir con criterio.

Paso a paso: cómo obtener tu DeepSeek API key

Este proceso cambia poco con el tiempo, aunque la interfaz puede variar. La lógica general es la misma: entrar en la plataforma, abrir el apartado de claves, crear una nueva y copiarla una sola vez para guardarla de forma segura.

1. Entra en la plataforma de DeepSeek. Abre platform.deepseek.com e inicia sesión con tu cuenta.
2. Ve al área de API. Dentro del panel, busca el apartado de claves o credenciales de API.
3. Crea una nueva clave. Pulsa la opción para generar una API key nueva. Si la interfaz te permite añadir un nombre, usa uno descriptivo, por ejemplo local-macbook, staging o produccion-backend.
4. Copia la clave en el momento de creación. Normalmente estas credenciales se muestran una vez o se ocultan parcialmente después. Guárdala en tu gestor de contraseñas o en un archivo .env local.
5. No la pegues en código fuente. Evita dejarla en archivos JavaScript, Python o notebooks que vayan a subirse a GitHub.
6. Prueba la autenticación. Haz una llamada simple al endpoint de chat para verificar que la clave funciona.

Si durante el registro aparece un error con el correo electrónico, la propia FAQ oficial indica que algunos dominios no son compatibles para el alta y recomienda proveedores comunes como Gmail, Outlook, Hotmail o Yahoo.[4] Si te ocurre, cambia de dirección de correo antes de seguir.

Una práctica útil es crear claves separadas por entorno. Una para desarrollo local, otra para pruebas y otra para producción. Así puedes revocar una sola clave sin interrumpir todo el sistema.

Cómo configurar la clave en tu entorno local

Una vez creada tu DeepSeek API key, el siguiente paso es exponerla al programa sin incrustarla en el código. La opción más común es una variable de entorno llamada DEEPSEEK_API_KEY. La documentación oficial usa ese nombre en sus ejemplos.[2]

En macOS o Linux puedes definirla así en tu terminal:

export DEEPSEEK_API_KEY="tu_clave_aqui"

En Windows PowerShell, una forma habitual es esta:

$env:DEEPSEEK_API_KEY="tu_clave_aqui"

Si trabajas con un archivo .env, añade la variable y carga ese archivo con la herramienta que uses en tu proyecto. Aun así, no subas nunca ese archivo al repositorio. Inclúyelo en .gitignore desde el principio.

DeepSeek publica una API compatible con OpenAI. La documentación oficial sitúa la base en https://api.deepseek.com y expone modelos como deepseek-v4-flash y deepseek-v4-pro.[1][2] Si empleas SDK compatibles, normalmente solo necesitas cambiar la URL base y la clave.

Primera prueba con cURL y ejemplo mínimo

La forma más rápida de comprobar si tu clave funciona es una petición por terminal. Este ejemplo sigue el formato documentado por DeepSeek para /chat/completions.[2]

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Di hola en español."}
    ],
    "stream": false
  }'

Si prefieres usar un cliente compatible con OpenAI, DeepSeek también documenta la URL base para ese formato en https://api.deepseek.com. Además, la guía del artículo puede apoyarse en el endpoint compatible /v1/ cuando el SDK o la herramienta lo requieran para mantener la interfaz esperada por clientes OpenAI compatibles.[1][2]

Si la respuesta devuelve un error 401, casi siempre hay una de estas causas: clave mal copiada, variable de entorno vacía, espacio extra al pegarla o cuenta sin acceso operativo. Si el error es de límite o concurrencia, DeepSeek aclara que la limitación es dinámica según la carga del servidor.[5]

Qué modelo elegir y cuánto te puede costar

Elegir el modelo antes de escribir demasiado código te ahorra cambios después. En mayo de 2026, la página oficial de precios muestra dos opciones V4 principales y una referencia heredada V3.2 en transición.[1][3]

Modelo	Entrada por 1M tokens	Entrada cache hit	Salida por 1M tokens	Notas
DeepSeek V4 Flash	$0,14	$0,028	$0,28	1M contexto, hasta 384K salida
DeepSeek V4 Pro	$1,74	$0,145	$3,48	Incluye modo thinking-max
V3.2 legacy	$0,28	—	$0,42	Alias antiguos en retirada

La documentación oficial confirma para V4 un contexto de 1M tokens, una salida máxima de 384K y compatibilidad con herramientas, JSON Output y llamadas a herramientas.[1] También indica que DeepSeek V4 Flash soporta modo con razonamiento y sin razonamiento, mientras que V4 Pro añade el nivel más alto de razonamiento, descrito en la documentación del producto como thinking-max.[1]

Si vas a construir prototipos, asistentes internos, automatizaciones o pruebas de integración, DeepSeek V4 Flash suele ser el punto de partida lógico por precio. Si necesitas más capacidad en tareas complejas, generación larga o razonamiento intenso, DeepSeek V4 Pro encaja mejor. Para estimar consumo real, revisa la página principal de precios y define un límite mensual por proyecto.

Un detalle importante: los alias deepseek-chat y deepseek-reasoner están marcados para retirada el 24 de julio de 2026.[1][3] Si hoy empiezas una integración nueva, usa directamente deepseek-v4-flash o deepseek-v4-pro para evitar una migración inmediata.

Además, DeepSeek mantiene pesos abiertos bajo licencia MIT para parte de su ecosistema, según la documentación oficial de la API.[2] Eso no sustituye a la API hospedada, pero sí forma parte del contexto técnico del producto y explica por qué el ecosistema alrededor de DeepSeek crece rápido.

Buenas prácticas para proteger tu API key

La diferencia entre una prueba limpia y un incidente suele estar aquí. Una clave expuesta puede generar coste, bloquear flujos internos o obligarte a rotar credenciales en producción.

• Usa variables de entorno. Es la opción base para desarrollo y despliegue.
• No compartas una sola clave entre todos los entornos. Segmenta por proyecto o por etapa.
• Guarda la clave en un gestor de secretos. En producción, mejor que un simple archivo plano.
• Revoca claves antiguas. Si una máquina deja de usarse, elimina su credencial.
• Vigila el uso por clave. La FAQ oficial incluye una referencia para consultar uso por API key.[4]
• No publiques capturas del panel. Una captura puede filtrar identificadores, nombres de claves o metadatos útiles para un atacante.

Si sospechas que una clave se ha filtrado, actúa en este orden: revócala, genera una nueva, actualiza variables de entorno, despliega de nuevo y revisa el consumo reciente. Es una operación simple si separaste claves por entorno desde el inicio.

También conviene evitar nombres ambiguos. Una clave llamada api-key-1 no ayuda cuando toca rotar credenciales. Un nombre como backend-prod-eu o cli-local-dani reduce errores operativos.

Preguntas frecuentes

¿La DeepSeek API key sirve para todos los modelos?

Sí, la clave autentica tu cuenta frente a la API. Después eliges el modelo en el parámetro model, por ejemplo deepseek-v4-flash o deepseek-v4-pro.[1][2]

¿Puedo usar la API de DeepSeek con herramientas compatibles con OpenAI?

Sí. DeepSeek documenta compatibilidad con el formato de OpenAI y permite configurar la URL base de su servicio para clientes compatibles.[1][2] En muchos casos basta con cambiar la URL base y la variable de entorno de la clave.

¿Qué pasa con deepseek-chat y deepseek-reasoner?

Siguen existiendo por compatibilidad, pero están programados para su deprecación el 24 de julio de 2026.[1][3] Si empiezas ahora, usa los nombres actuales de V4.

¿Cuál es el modelo más barato para empezar?

En mayo de 2026, DeepSeek V4 Flash es la opción V4 más económica: $0,14 por 1M tokens de entrada y $0,28 por 1M tokens de salida.[1] Suele ser la mejor elección para pruebas iniciales y automatizaciones con presupuesto ajustado.

¿Dónde debo guardar la clave?

Guárdala en variables de entorno o en un gestor de secretos. No la pongas en código fuente, repositorios públicos, capturas de pantalla ni archivos compartidos por correo electrónico. La autenticación oficial usa Bearer Auth, así que quien tenga la clave puede hacer peticiones en tu nombre.[2]

¿DeepSeek ofrece contexto largo en la API?

Sí. La documentación oficial de precios y modelos muestra un contexto de hasta 1M tokens y una salida máxima de 384K tokens para la línea V4.[1]

Recursos relacionados

• Guía principal sobre DeepSeek en español
• Precios de DeepSeek actualizados
• Documentación de la API explicada
• Probar DeepSeek Chat antes de usar la API
• Ficha de DeepSeek V4 Flash
• Ficha de DeepSeek V4 Pro

Conclusión

Obtener una deepseek api key es un proceso corto: crear cuenta, generar la clave, guardarla fuera del código y verificarla con una llamada simple. La parte que más problemas evita no es el clic inicial, sino la higiene operativa posterior: variables de entorno, claves separadas por entorno y uso de nombres claros. Si vas a empezar hoy, lo más sensato es crear una clave para desarrollo, probar deepseek-v4-flash con cURL y dejar preparada la estructura para rotación de secretos desde el primer despliegue.

Fuentes

’]