Inicio rápido: Integración de la API de DeepSeek Coder

URL Base y Autenticación

Tu clave API autentica cada solicitud a nuestro endpoint alojado. Utiliza la URL base https://api.coderdeepseek.cc/v1 con cualquier SDK de OpenAI o cliente HTTP. El identificador del modelo es estrictamente uncensored. Esto se ejecuta en nuestros propios servidores y no es una reventa del modelo de otro proveedor. Recibe una clave de API inmediata al registrarte mediante Google o correo electrónico. Mantén esta clave segura, ya que controla tu crédito prepagado.

La autenticación se basa en el Authorization header. Pasa tu clave como un token Bearer. Cada solicitud debe incluir este encabezado para evitar un 401 error. No utilizamos parámetros de consulta para la autenticación. Esto asegura encabezados limpios y compatibilidad con middleware estándar.

Enviar solicitudes: Finalizaciones de chat

El endpoint de completado de chat procesa tus prompts y devuelve salidas de texto. Envía una solicitud POST a /v1/chat/completions. Incluye el nombre del modelo, el array de mensajes y los parámetros deseados. El sistema procesa texto de entrada y devuelve texto de salida. Puedes controlar el formato de la respuesta y los criterios de parada. Esto funciona tanto para consultas simples como para tareas de programación complejas.

Utiliza el siguiente comando curl para probar tu conexión. Reemplaza YOUR_API_KEY con tu clave real. La solicitud utiliza el uncensored identificador del modelo. Esto confirma que tu autenticación y saldo de crédito están activos.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Verifica que la respuesta contenga el choices array. Cada opción incluye un mensaje con el contenido generado. Comprueba el usage objeto para contar los tokens. Esto te ayuda a monitorizar tus gastos con precisión.

Integración del SDK de Python

Integra la API en tus proyectos Python utilizando el paquete oficial de OpenAI. Establece la URL base en nuestro punto de conexión. Inicializa el cliente con tu clave de API. Esto te permite usar métodos familiares como chat.completions.create. El SDK maneja la serialización JSON y las solicitudes HTTP automáticamente.

Configura el modelo a uncensored. Pasa tus mensajes en el formato estándar. El SDK soporta todas nuestras funciones incluyendo function calling y JSON mode. Puedes establecer parámetros como temperature y top_p directamente. Esto facilita la migración desde otros proveedores.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.coderdeepseek.cc/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)

Maneja excepciones para errores de red o solicitudes inválidas. Verifica el código de estado si analizas la respuesta sin procesar. Esto garantiza un manejo de errores robusto en tu aplicación. El SDK abstrae la mayor parte de la complejidad.

Integración del SDK Node

Usa el SDK de OpenAI para Node.js para integrarte con tus proyectos en JavaScript o TypeScript. Instala el paquete y configura la URL base. Esto mantiene la compatibilidad con tu estructura de código existente. Puedes usar los mismos métodos que en Python. El SDK admite tanto módulos CommonJS como ES.

Establece el modelo a uncensored. Pasa tus mensajes y parámetros. El SDK maneja las solicitudes de streaming y no streaming. Puedes capturar errores y registrarlos adecuadamente. Esto asegura que tu aplicación permanezca estable bajo carga.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.coderdeepseek.cc/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);

Prueba tu integración con un prompt sencillo. Verifica que la respuesta coincida con tus expectativas. Comprueba el uso de tokens en el objeto de respuesta. Esto te ayuda a rastrear costes y rendimiento. El SDK facilita iterar rápidamente.

Respuestas en streaming y uso de tokens

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve un flujo de Eventos Enviados por Servidor (SSE). Recibes fragmentos de texto a medida que se generan. Esto reduce la latencia percibida para respuestas largas. El último fragmento contiene el uso total de tokens.

Analiza los eventos SSE para extraer el contenido. Concatena los fragmentos para formar la respuesta completa. Monitoriza el usage objeto en el último fragmento. Esto te da conteos de tokens precisos para la facturación. El streaming es ideal para aplicaciones en tiempo real.

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 interrupciones de red de forma elegante. Reconecta si la transmisión se cae. La API no reenvía fragmentos anteriores. Debes reconstruir el texto completo en el lado del cliente. Esto proporciona una experiencia de usuario fluida.

Límites, Errores y Ventana de Contexto

Nuestra API impone límites estrictos para garantizar la estabilidad. Puedes realizar 300 solicitudes por minuto por clave. Hasta 8 solicitudes pueden ejecutarse simultáneamente. El cuerpo de la solicitud no debe exceder los 8 MB. Exceder estos límites resulta en un 429 error de límite de tasa. Maneja estos errores con retroceso exponencial.

La ventana de contexto es de 100.000 tokens. Esto incluye tanto el prompt como la completación. La salida máxima es de 16.000 tokens por solicitud. Si no estableces max_tokens, por defecto, son 2,048. A 401 error significa que tu clave es inválida. Una 402 error significa que no tienes crédito. Recarga vía cripto para continuar usando el servicio.