URL Base y Autenticación
Inicia cada solicitud apuntando tu cliente a la URL base correcta. Usa la clave que recibiste durante el registro para pasar en el Authorization header. Este encabezado autentica tu cuenta y rastrea el uso de tu crédito prepagado.
Nuestra infraestructura está diseñada para desarrolladores que desean acceso directo sin tarifas de enrutamiento intermedias. Obtienes un rendimiento constante porque ejecutamos nuestros propios servidores.
Primera solicitud
Envía tu primer mensaje para verificar la conectividad y la respuesta del modelo. Usa el endpoint estándar de chat completions con tu prompt del sistema y la consulta del usuario. Esto confirma que tu clave funciona y muestra la respuesta JSON en crudo.
- Establece el
modelfield touncensored. - Incluir un mensaje de usuario simple para probar la latencia.
- Verifica el
usageobjeto para contar los tokens.
SDK de Python
Integra rápidamente usando la biblioteca oficial de Python. Instala el paquete e inicializa el cliente con tu URL base y clave. Este enfoque maneja la serialización y los reintentos automáticamente.
Define tu historial de conversación como una lista de diccionarios. Pásalos directamente al endpoint de chat. La biblioteca devuelve un objeto de respuesta estructurado que puedes analizar para obtener el texto del asistente.
SDK Node
Crea lógica del lado del servidor con el cliente Node.js. Importa la librería y configura la clave de API y la URL base. Esta configuración funciona bien para servicios backend que procesan entradas de usuario de forma asíncrona.
Llama al método de finalización con tus mensajes. La respuesta incluye el texto generado y las estadísticas de uso. Maneja los errores de manera elegante para evitar que tu aplicación se bloquee durante cargas altas.
Respuestas en streaming
Recibe tokens en tiempo real para una experiencia de usuario más fluida. Habilita la transmisión configurando la bandera adecuada en tu solicitud. El servidor envía fragmentos de datos a medida que se generan.
Acumula estos fragmentados en el lado del cliente para mostrar el texto progresivamente. Esto reduce significativamente la latencia percibida. Monitorea el último fragmento para el uso total de tokens y los datos de facturación.
Límites, Errores y Contexto
Respeta los límites de velocidad para evitar interrupciones. Tienes permitido realizar 300 solicitudes por minuto y 8 conexiones concurrentes por clave. Si excedes esto, recibirás un error 429.
Un error 401 significa que tu clave API es inválida. Un error 402 indica saldo prepagado insuficiente. Tu ventana de contexto es de 100,000 tokens en total. Mantén tu prompt y respuesta dentro de este límite para garantizar un rendimiento fiable.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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
stream = 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)