La API de DeepSeek se usa mucho para atención al cliente, redacción, programación y análisis de datos por su bajo precio y su sólida capacidad en chino. Este artículo de ZSQH AI Gateway explica cómo obtener una clave, cómo recargar, cómo llamar a la API con el SDK de OpenAI y qué hacer cuando alcanzas los límites de peticiones.

Este artículo usa como ejemplo la interfaz compatible con OpenAI. La interfaz oficial de DeepSeek también es compatible con el SDK de OpenAI, pero la Base URL y los nombres de modelo son distintos. No las mezcles.

1. Qué puede hacer la API de DeepSeek

Usos habituales:

  • Preguntas y respuestas en chino y bots de atención al cliente.
  • Resumen, traducción y reescritura de documentos largos.
  • Generación y explicación de código.
  • Análisis de datos y extracción estructurada.
  • Nodos de razonamiento en agentes y flujos de trabajo.

Los modelos DeepSeek habituales incluyen deepseek-chat y deepseek-reasoner. Para conocer los nombres de modelo disponibles, las longitudes de contexto y los precios concretos, consulta la página de precios de modelos.

2. Registro y creación de la clave

  1. Abre ZSQH AI Gateway, regístrate e inicia sesión.
  2. Ve a la página "API Keys" y haz clic en Crear.
  3. Ponle un nombre como deepseek-test o deepseek-prod.
  4. Fija un límite de gasto y una fecha de caducidad.
  5. Copia la clave y guárdala en un lugar seguro.

Recomendamos claves separadas para pruebas y producción. No pongas claves de producción en el código del front-end.

3. Recarga

Recarga en la página "Wallet". Una vez abonado el pago, la consola muestra el saldo.

Si es tu primera vez, empieza con una cantidad pequeña y ajústala según el uso real cuando la integración funcione. Los precios de DeepSeek son relativamente bajos, pero los contextos largos y los trabajos por lotes aún pueden consumir el saldo rápidamente.

4. Base URL y nombres de modelo

El endpoint compatible con OpenAI de ZSQH:

https://ai.zhongshangqihang.com/v1

Ejemplos de nombres de modelo:

deepseek-chat
deepseek-reasoner

Notas:

  • Los nombres de modelo están sujetos a la página de precios; no copies nombres antiguos directamente de la documentación oficial.
  • Si usas la interfaz oficial de DeepSeek, la Base URL es https://api.deepseek.com; con el gateway, usa la dirección anterior.
  • No mezcles las dos Base URL o recibirás errores 401/404.

5. Llamadas desde Python

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain what a vector database is in three sentences"},
    ],
)

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

Si necesitas el proceso de razonamiento, cambia a deepseek-reasoner. Ten en cuenta que los modelos de razonamiento suelen ser más lentos y caros; encajan en problemas difíciles, no en todas las peticiones.

6. Llamadas con curl

export DEEPSEEK_API_KEY="sk-your-key"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Write a Python example that reads a CSV file"}
    ]
  }'

7. Límites de peticiones y estabilidad

DeepSeek puede limitar las peticiones o ralentizarlas en horas punta. En la práctica:

  1. Configura tiempos de espera y reintentos: no esperes indefinidamente; usa retroceso exponencial para 429/5xx.
  2. Controla la concurrencia: no lances todos los trabajos por lotes a la vez.
  3. Prepara un modelo de respaldo: las cargas críticas pueden configurarse con un modelo o canal de respaldo.
  4. Monitoriza las tasas de error: cuenta 401/429/5xx cada hora y cambia de canal cuando se disparen.
  5. Divide el texto largo: los contextos muy largos son lentos y caros; resume o fragmenta primero.

8. Errores comunes

Error Causa Qué hacer
401 Clave incorrecta o falta Bearer Revisa la clave y las cabeceras de la petición
404 Base URL incorrecta Usa la dirección del gateway que termina en /v1
model not found Nombre de modelo incorrecto Cópialo de la página de precios
429 Límite de peticiones alcanzado Reduce la concurrencia, reintenta, cambia al canal de respaldo
insufficient quota Saldo insuficiente Recarga
Respuesta muy lenta Horas punta o contexto largo Acorta el contexto, cambia de modelo, reintenta

9. DeepSeek oficial frente a gateway

Aspecto Directo oficial ZSQH Gateway
Acceso Depende del entorno de red Punto de entrada unificado, normalmente más estable
Pago Métodos que admite el sitio oficial Recarga en el sitio
Modelos Solo DeepSeek Claude, GPT, Gemini y otros
Facturación Panel oficial Consola unificada
Cambio Cambiar de proveedor requiere cambios de código Cambia el nombre del modelo

Si solo usas DeepSeek, tu uso es estable y el acceso oficial funciona bien, el acceso directo es una opción. Si necesitas varios modelos, facturación unificada o acceso estable desde China, un gateway encaja mejor.

10. Recomendaciones de seguridad

  • No pongas claves en el código del front-end ni en repositorios públicos.
  • Crea claves separadas para pruebas y producción.
  • Fija límites de gasto para evitar llamadas anómalas.
  • Revisa los registros de uso con regularidad y desactiva las claves cuanto antes si algo parece raro.
  • Elimina las claves antiguas cuando un empleado se vaya o se sustituya una máquina.

Preguntas frecuentes

¿La API de DeepSeek es gratuita?

Suele haber créditos para nuevos usuarios o promociones, pero el uso a largo plazo requiere recargar. Consulta las políticas oficiales y del sitio para los detalles.

¿Puede una clave llamar a Claude?

En ZSQH Gateway, una clave puede llamar a varios modelos habilitados; especifica el modelo en los parámetros de la petición. Consulta la página de precios para más detalles.

¿Por qué el mismo modelo a veces va rápido y a veces lento?

Puede verse afectado por la carga upstream, la longitud del contexto, la concurrencia y las condiciones de red. Para producción, añade tiempos de espera, reintentos y un modelo de respaldo.

Próximos pasos

Primero regístrate en ZSQH AI Gateway, crea una clave de prueba deepseek, verifícala con curl y después conecta tu aplicación. Los precios y nombres de modelo están sujetos a precios de modelos.

Lecturas relacionadas: