API de DeepSeek V4: primera petición en cinco minutos

Autenticación y URL base

Nuestra API utiliza autenticación estándar con clave de API. Puedes generar una clave al instante en la página Obtener clave de API ingresando tu correo electrónico y contraseña. No se requiere tarjeta de crédito para la prueba, que incluye $0,50 en crédito válido durante 7 días. Una vez que tengas tu clave, configura tu cliente para usar nuestra URL base: https://api.deepseek4api.com/v1.

Establece la cabecera Authorization a Bearer YOUR_API_KEY. Esta URL base funciona con cualquier SDK compatible con OpenAI. El identificador de modelo que debes especificar en tus peticiones es uncensored. Esto asegura que interactúas con nuestro modelo de pesos abiertos ajustado para respuestas sin restricciones, en lugar de cualquier variante específica de proveedor.

Finalización de chat básica

Envía una petición estándar de finalización de chat para generar texto. La API acepta una lista de mensajes que contienen los campos role y content. A continuación se muestra un ejemplo básico de cURL que demuestra una consulta de texto simple. Esto funciona para cualquier cliente compatible con OpenAI ajustando la URL base y el ID del modelo.

Copycurl https://api.deepseek4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Reemplaza YOUR_API_KEY con tu clave generada. La respuesta contendrá una matriz estándar choices con el texto generado. Ten en cuenta que este endpoint admite llamadas a funciones, permitiéndote integrar salidas estructuradas en tus aplicaciones.

Integración con SDK de Python

Usa el SDK oficial de OpenAI para Python para interactuar con nuestra API. Configura el cliente con nuestra URL base y tu clave de API. El nombre del modelo es uncensored. Esto te permite mantener tu código cliente mientras cambias el modelo de backend.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseek4api.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Asegúrate de tener el paquete openai instalado. El código anterior demuestra una petición síncrona. Para aplicaciones asíncronas, puedes usar el cliente AsyncOpenAI con la misma configuración. Este método es ideal para servicios de backend donde necesitas generación de texto fiable y sin streaming.

Uso del SDK de Node.js

Para aplicaciones Node.js, usa el paquete npm openai. Inicializa el cliente con baseURL apuntando a nuestro servicio y proporciona tu clave de API. El ID del modelo sigue siendo uncensored.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseek4api.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Esta configuración te permite integrar capacidades de LLM sin censura en tus proyectos de JavaScript o TypeScript. El SDK maneja la serialización JSON y las peticiones HTTP automáticamente. Puedes ampliar esta configuración básica para incluir herramientas o llamadas a funciones si tu aplicación requiere salidas de datos estructuradas.

Respuestas en streaming

Para generación de texto en tiempo real, habilita el streaming en tu cliente. Establece stream: true en los parámetros de tu petición. La API devuelve Server-Sent Events (SSE), permitiéndote procesar tokens a medida que se generan. Esto reduce la latencia percibida para los usuarios finales.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Maneja los eventos del flujo en tu código para mostrar texto de forma incremental. El streaming funciona con los SDKs de Python y Node. Asegúrate de que tu cliente cierre correctamente la conexión del flujo cuando la respuesta esté completa o si ocurre un error. Esta función es esencial para interfaces de chat donde la retroalimentación inmediata es crítica.

Límites, errores y contexto

La API aplica una ventana de contexto de 100,000 tokens para el prompt y la respuesta combinados. Los cuerpos de las peticiones no deben superar 8 MB. Tienes un límite de 300 peticiones por minuto por clave de API. Si superas este límite, recibirás un error de límite de peticiones con código 429.

Los errores de autenticación devuelven 401 si la clave no es válida. Los errores de facturación devuelven 402 si se agota tu crédito prepago. A diferencia de las suscripciones, nuestros créditos de pago por uso nunca caducan. Regenera tu clave en cualquier momento desde el panel, lo que revoca instantáneamente la clave antigua. Esto asegura una gestión segura del acceso sin tiempo de inactividad.