Documentación de API Compatible con OpenAI

Configuración de autenticación y URL base

Tu clave API autentica cada solicitud a nuestros servidores. Simplemente regístrate con Google o una dirección de correo electrónico y copia la clave desde tu panel. Pégala en tu variable de entorno como DEEPSEEK_API_KEY y apunta tu cliente a https://api.keyapideepseek.com/v1.Esta URL base funciona con cualquier biblioteca estándar compatible con OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Puedes verificar tu configuración enumerando los modelos disponibles. La respuesta confirma que tu clave es válida y está activa. Este paso asegura que tu integración apunte al punto de conexión sin censura correcto antes de enviar prompts.

Endpoint Chat Completions

El POST /v1/chat/completions el endpoint acepta tu prompt y devuelve la respuesta del modelo. Envías un cuerpo JSON que contiene mensajes, tus instrucciones del sistema y parámetros como la temperatura. El id del modelo es siempre uncensored. Este único modelo maneja todas tus necesidades de generación de texto sin complejidad de enrutamiento.

Copyfrom openai import OpenAI

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

El SDK de Python maneja las solicitudes HTTP automáticamente. Pasas tu clave y la URL base al constructor del cliente. El resto del código refleja los patrones estándar de OpenAI. Esto asegura que puedas cambiar de proveedor más tarde sin reescribir toda la lógica de tu aplicación.

Respuestas en streaming y uso de tokens

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve un flujo de fragmentos de Eventos Enviados por el Servidor (SSE). Cada fragmento contiene texto parcial y estadísticas de uso. El último fragmento incluye los recuentos totales de tokens para la solicitud.

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)

El streaming reduce la latencia percibida para los usuarios. Puedes mostrar los tokens a medida que llegan. Esto es crucial para la generación de texto largo o interfaces de chat interactivas. Monitorea el uso de tokens en el último fragmento para rastrear el consumo de tu crédito prepagado con precisión.

Modo JSON y llamada de funciones

Aplica una salida estructurada estableciendo response_format para {"type": "json_object"}. El modelo devolverá JSON válido en lugar de texto de formato libre. Esto es ideal para integraciones de API o tareas de extracción de datos. También puedes definir definiciones de funciones en tu prompt para el uso de herramientas.

El modelo soporta tool_choice parámetros. Puede forzar funciones específicas o dejar que el modelo decida. Esta flexibilidad le permite construir agentes complejos. Asegúrese de que los esquemas de sus funciones estén fuertemente tipados para evitar errores de análisis en su código cliente.

Límites de velocidad y concurrencia

Cada clave de API está limitada a 300 solicitudes por minuto. Puedes tener hasta 8 solicitudes concurrentes activas simultáneamente. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Estos límites previenen el abuso y garantizan un rendimiento estable para todos los usuarios. Exceder estos límites devuelve un error 429.

Implementa un retroceso exponencial en tu código cliente. Reintenta las solicitudes fallidas tras un breve retraso. Esto maneja los problemas transitorios de red de manera elegante. Tu crédito prepagado se cobra solo por las completaciones exitosas, no por los reintentos limitados por velocidad.

Gestión de errores y rechazos

Un error 401 significa que tu clave es inválida o ha expirado. Un error 402 indica saldo prepagado insuficiente. Un error 429 señala que has alcanzado el límite de tasa. El modelo rechaza solicitudes que contienen contenido sexual que involucra a menores. Todo otro contenido adulto lícito está permitido.

Comprueba el cuerpo de la respuesta de error para mensajes detallados. Registra estos errores para depurar problemas de integración. Tu crédito no se consume para las solicitudes fallidas. Este modelo de facturación transparente te ayuda a predecir los costes con precisión sin tarifas ocultas.

Node.js

Copyimport OpenAI from "openai";

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