Documentación de la API para desarrolladores

URL Base y Autenticación

Empieza por cambiar la URL base a nuestro punto de conexión dedicado y pasa tu clave de API en el encabezado Authorization. No usamos la URL base estándar de OpenAI; debes apuntar tu SDK a https://api.deepseektokenplan.com/v1. Esto asegura que tus solicitudes se enruten a través de nuestra infraestructura de modelos sin censura. El ID de modelo que especificas en el cuerpo de la solicitud es "uncensored", lo que activa los pesos específicos ajustados en nuestros servidores. La autenticación se basa en un esquema simple de token Bearer que funciona con cualquier biblioteca cliente compatible con OpenAI. Tu clave se genera al instante al registrarte con Google o correo electrónico, sin necesidad de número de teléfono. Mantén esta clave segura, ya que está vinculada directamente al saldo de tu crédito prepagado.

Primera solicitud

Envía una solicitud de finalización de chat estándar usando cURL para verificar tu configuración y la disponibilidad del modelo. Esta sencilla solicitud POST demuestra cómo la API acepta tu prompt del sistema y el mensaje del usuario. Puedes ajustar los parámetros temperature y top_p para controlar la creatividad. La respuesta devuelve el texto generado junto con estadísticas de uso de tokens para una facturación transparente. Asegúrate de que el cuerpo de tu solicitud incluya el identificador del modelo correcto y tu clave API en el encabezado. Este método funciona tanto para la generación de texto como para la llamada de funciones. Utiliza este comando para confirmar la conectividad antes de integrarlo en tu aplicación. El punto de conexión admite modos de transmisión y sin transmisión por igual.

Integración del SDK de Python

Utiliza la biblioteca oficial de Python de OpenAI para interactuar con nuestra API configurando la URL base y la clave de API. Inicializa el cliente con tus credenciales y llama al método de finalizaciones de chat con el ID de modelo deseado. Este enfoque te permite aprovechar las bases de código existentes que se crearon para OpenAI sin una refactorización importante. Puedes transmitir respuestas o recibir el texto completo de una vez. La biblioteca maneja automáticamente la serialización JSON y las solicitudes HTTP. Configura los ajustes de tiempo de espera y reintento según sea necesario para tu caso de uso específico. Este método es ideal para servicios backend y tuberías de procesamiento de datos. Asegúrate de actualizar la URL base para que apunte a nuestro punto de conexión específico.

Integración del SDK Node

Integra la API en tus aplicaciones JavaScript o TypeScript usando el paquete Node de OpenAI. Establece la URL base y la clave API en la configuración del cliente antes de hacer cualquier solicitud. Esta configuración te permite usar métodos familiares como chat.completions.create() con nuestro modelo sin censura. Puedes pasar parámetros como temperatura y secuencias de parada para ajustar la salida. El SDK maneja las respuestas de streaming de manera eficiente para aplicaciones en tiempo real. Usa este enfoque para servidores web o herramientas de línea de comandos. Asegúrate de importar los módulos necesarios y configurar las variables de entorno correctamente. Este método admite patrones de solicitud tanto sincrónicos como asíncronos.

Streaming y tokens

Habilita el streaming para recibir respuestas parciales a medida que se generan, mejorando la experiencia del usuario en interfaces de chat. La API utiliza Server-Sent Events (SSE) para entregar tokens en tiempo real. Puedes rastrear el uso de tokens en el último fragmento del flujo para una facturación precisa. Esta función es compatible con todas las bibliotecas SDK principales y se puede implementar manualmente si es necesario. El streaming reduce la latencia percibida para respuestas largas. Establece el stream parámetro a true en el cuerpo de tu solicitud. La API devuelve estadísticas de uso en el último evento, permitiéndote deducir la cantidad correcta de tu crédito prepagado. Este método es esencial para aplicaciones que requieren retroalimentación inmediata.

Límites y manejo de errores

Monitorea tus límites de tasa y maneja los errores de forma elegante para garantizar una conexión estable. La API permite 300 solicitudes por minuto por clave y 8 solicitudes concurrentes. El cuerpo de cada solicitud no debe exceder 8 MB. Si envías una clave no válida, recibirás un error 401 No autorizado. Un error 402 indica crédito prepagado insuficiente, lo que requiere que recargues mediante criptomonedas. Un error 429 significa que has excedido el límite de tasa; espera y reintenta. La ventana de contexto es de 100,000 tokens para prompt y finalización combinados. La salida máxima es de 16,000 tokens a menos que especifiques un valor inferior max_tokens valor. Revisa siempre el código de estado y el cuerpo de la respuesta para mensajes de error detallados.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Transmisión

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)