Cómo empezar con la API de DeepSeek

La API permite que un programa envíe una solicitud a DeepSeek y procese la respuesta. Esta guía propone una primera petición pequeña para comprobar la conexión antes de añadir archivos, herramientas o conversaciones extensas.

Si solo quieres hablar con el asistente, utiliza el chat oficial y nuestra guía de uso. Aquí trabajaremos con el acceso para desarrolladores.

1. Prepara la clave y el entorno

Arquitectura propuesta

Dónde permanece la clave

Ver imagen a tamaño completo ↗

1. El navegador envía la tarea a tu aplicación.
2. Tu servidor conserva la clave, prepara la petición y consulta la API.
3. La respuesta vuelve a tu servidor y después al navegador.

Accede a la plataforma oficial de DeepSeek y utiliza su gestión de claves para obtener una clave API. Revisa también el saldo de esa plataforma. Una clave identifica el acceso de tu aplicación; no debe aparecer en el HTML público, un repositorio compartido o una captura de pantalla.

Guárdala en un gestor de secretos o en la variable de entorno DEEPSEEK_API_KEY del proceso que hará la petición. Para un sitio web, el navegador debe comunicarse con tu servidor, y el servidor con el proveedor. Evita distribuir la clave entre los visitantes.

2. Construye una petición pequeña

La referencia oficial documenta POST /chat/completions, con una lista de mensajes y el modelo. El ejemplo siguiente usa deepseek-flash, desactiva el modo de razonamiento y limita la salida. La autenticación utiliza el encabezado Bearer documentado por DeepSeek.

Ejemplo para una terminal con sintaxis Bash y la variable ya configurada:

curl https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "user", "content": "Propón un título breve en español para una guía sobre plantas de interior."}
    ],
    "thinking": {"type": "disabled"},
    "max_tokens": 120,
    "stream": false
  }'

El texto solicitado es deliberadamente sencillo. El objetivo inicial es comprobar la conexión y el tratamiento de la respuesta, no evaluar la calidad general del modelo. El ejemplo no se ha ejecutado y no incluye una salida simulada.

3. Revisa la respuesta completa

En una respuesta correcta de Chat Completions, el contenido se encuentra en choices[0].message.content. Comprueba además finish_reason y usage: el primero ayuda a entender cómo terminó la generación y el segundo informa del consumo.

Guarda en tus registros el modelo solicitado, el código HTTP, la duración y el consumo necesario para diagnosticar el comportamiento. Evita registrar la clave o el documento completo si no hacen falta para ese diagnóstico.

4. Define qué hará tu aplicación con el resultado

No conectes automáticamente el primer texto recibido a una acción importante. Primero comprueba que la respuesta tiene el formato esperado. Si solicitas una categoría, valida que pertenece a tu lista; si solicitas un número, comprueba su tipo y rango. Cuando la salida no sea válida, conserva un error claro para revisión.

Separa también la generación de la publicación. Un borrador puede necesitar aprobación editorial aunque la petición se haya completado sin errores técnicos.

5. Prepara presupuesto y fallos

Calcula el coste de una tarea completa con la guía de precios. Empieza con un volumen controlado y un límite de gasto que puedas revisar. Si falla una petición, identifica el código antes de repetirla: la guía de errores organiza las comprobaciones.

Cuando tengas esa base, estudia la caché de contexto para entradas repetidas o la interfaz compatible con Anthropic si tu aplicación utiliza su SDK. El índice de documentación reúne los siguientes pasos.

Documentación oficial consultada el 12 de septiembre de 2026. DEspañol es una publicación independiente; los ejemplos son educativos y no se han ejecutado contra la API.