Guía de Usuario de la API DeepSeek V4

1. Registro y Autenticación

La API de DeepSeek V4 es compatible con el SDK de OpenAI, lo que reduce significativamente los costos de migración y permite a los desarrolladores integrarse perfectamente con las herramientas existentes del ecosistema de IA.

Obtener una Clave API

1. Visite Plataforma DeepSeek.
2. Haga clic en "API Keys" -> "Create new secret key" en la esquina superior derecha.
3. Nota: La clave solo se muestra una vez al crearla, así que guárdela de forma segura.

2. Inicio Rápido (Ejemplo en Python)

Primero, instale el SDK oficial de OpenAI (sí, leyó bien, solo use el SDK de OpenAI):

pip install openai

Luego, simplemente modifique dos parámetros: base_url y api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # Su clave API de DeepSeek
    base_url="https://api.deepseek.com"  # ¡Punto clave!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # Nombre del modelo, puede diferir después del lanzamiento de V4
    messages=[
        {"role": "system", "content": "Eres un asistente de IA útil."},
        {"role": "user", "content": "Hola, por favor presenta DeepSeek V4."},
    ],
    stream=False
)

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

3. Funciones Avanzadas

3.1 Salida en Streaming

Para mejorar la experiencia del usuario, se recomienda habilitar la salida en streaming, lo que permite a los usuarios ver un efecto de generación similar al de una máquina de escribir.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Escribe un poema largo sobre ballenas"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 Llamada a Funciones (Function Calling)

DeepSeek V4 admite un potente Function Calling, capaz de analizar con precisión parámetros JSON, lo que lo hace ideal para crear Agentes.

3.3 Modo JSON

Si necesita que el modelo genere un formato JSON válido, asegúrese de especificar json_object en response_format y solicite explícitamente la salida JSON en el prompt.

4. Precios y Optimización de Costos

El precio de DeepSeek V4 es extremadamente asequible (precios específicos pendientes de anuncio oficial, referencia V3 a $0.14/M tokens). Para ahorrar aún más dinero:

• Caché de Prompt: V4 introduce un mecanismo de caché de contexto. Si su System Prompt es largo (por ejemplo, base de conocimientos), las solicitudes posteriores costarán significativamente menos debido a los aciertos de caché.
• Optimizar Contexto: No rellene con historial de chat irrelevante.

5. Mejores Prácticas

• Manejo de Errores: Asegúrese de implementar try-except, especialmente para errores rate_limit_exceeded (429), con una estrategia de reintento de retroceso exponencial.
• Configuración de Tiempo de Espera: Las tareas de razonamiento complejo pueden requerir tiempos de generación más largos, así que configure el tiempo de espera en 60s o más.
• System Prompt: Dé a V4 una "persona" clara y funcionará mejor.

¿Tiene problemas? Consulte nuestra Documentación de la API o únase a la comunidad de Discord para obtener ayuda.