API de DeepSeek: Potencia e eficiencia para desarrolladores

Primeros pasos con la API

Configurar el acceso comienza con la creación de una cuenta de desarrollador y la generación de una clave de API desde la sección de credenciales. El proceso de inicio rápido consta de tres pasos fundamentales: la configuración de la autenticación, la instalación del SDK y la ejecución de la solicitud inicial. La mayoría de los ingenieros completan las pruebas de su primera solicitud en menos de 15 minutos utilizando las plantillas de código proporcionadas.

La autenticación utiliza el formato de token de portador con claves que incluyen el prefijo "sk-". La URL base para todos los endpoints es https://api.deepseek.com/v1, siguiendo las convenciones RESTful tradicionales. Los encabezados obligatorios incluyen Authorization con su clave de API y el Content-Type definido como application/json. El límite de velocidad se aplica por clave individual, lo que permite a los equipos distribuir las cuotas entre differentes proyectos de forma independiente.

Para la instalación del SDK de Python, utilice el gestor de paquetes pip para añadir la biblioteca cliente oficial al entorno de desarrollo. El siguiente bloque de código muestra un flujo de trabajo completo para una solicitud inicial utilizando el endpoint de chat con el modelo DeepSeek V3:

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    max_tokens=500,
    temperature=0.7
)

print(response.choices[0].message.content)

Para los desarrolladores que prefieren realizar pruebas rápidas sin dependencias de librerías, la llamada equivalente mediante curl requiere una configuración explícita de los encabezados HTTP. Este método es ideal para verificar la conectividad del sistema o realizar integraciones en lenguajes que no cuentan con un SDK dedicado:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Hello, API!"}],
    "max_tokens": 100
  }'

El sistema devuelve respuestas en formato JSON que contienen el texto generado, estadísticas de uso de tokens y metadatos de la transacción. Las respuestas exitosas incluyen un arreglo de opciones con la salida del modelo, mientras que los errores devuelven códigos estandarizados para facilitar la depuración. El recuento de tokens aparece detallado en el objeto de uso, registrando los prompt_tokens, completion_tokens y total_tokens para garantizar la precisión en la facturación.

• Obtener la clave de API desde la pestaña de seguridad en el panel de desarrollador.
• Instalar el SDK de Python o utilizar solicitudes HTTP directas para mayor flexibilidad técnica.
• Validar la conectividad mediante una completación de chat sencilla antes de pasar a producción.
• Supervisar los encabezados de respuesta para verificar el estado de los límites de velocidad.

Las guías de inicio rápido en la documentación oficial cubren lenguajes adicionales como Node.js y Go, proporcionando ejemplos específicos para frameworks populares como Express, Flask y FastAPI. La configuración de webhooks para procesos asíncronos requiere una verificación del endpoint de destino durante la fase inicial de configuración.