Best LLM API Documentación
Guía de inicio rápido: Integración lista para usar
Integra nuestra API LLM sin censura en tu aplicación cambiando la URL base y la clave de API en tu base de código compatible con OpenAI existente.
Requisitos previos
Antes de realizar tu primera petición, asegúrate de tener una clave de API válida. Regístrate en la página Obtener clave de API para recibir tu clave al instante. No se requiere tarjeta de crédito para la prueba inicial. Necesitarás un entorno de lenguaje de programación compatible (Python 3.8+ o Node.js 18+) y el SDK oficial de OpenAI instalado en tu proyecto.
Nuestro servicio actúa como un reemplazo listo para usar para los endpoints estándar de chat-completions. No necesitas instalar una biblioteca de cliente personalizada; el SDK estándar de OpenAI maneja el protocolo de comunicación, incluyendo streaming y llamadas a herramientas, siempre que configures correctamente la URL base.
Autenticación
La autenticación se maneja mediante el encabezado Authorization. Pasa tu clave de API como un token Bearer. Si la clave no es válida o ha expirado, la API devuelve un error 401 Unauthorized. Si el saldo de tu cuenta es insuficiente, recibes un error 402 Payment Required. Añade tu clave a tus variables de entorno o archivo de configuración para evitar codificar las credenciales.
- Encabezado:
Authorization: Bearer YOUR_API_KEY - URL base:
https://api.bestllmapi.com/v1
Mantén tu clave segura. Puedes regenerarla en cualquier momento desde tu panel, lo que invalida inmediatamente la clave anterior.
Completado básico de chat
Envía una petición POST a /v1/chat/completions con un ID de model de uncensored y tu historial de mensajes. La API devuelve una respuesta de texto. Este endpoint admite estructuras JSON estándar de OpenAI, facilitando la migración desde otros proveedores.
Asegúrate de estructurar correctamente tus mensajes con roles como system, user y assistant. El modelo procesa la entrada y genera la respuesta basada en el contexto de tu prompt.
curl https://api.bestllmapi.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."}]
}'
Respuestas en streaming
Para experiencias de usuario en tiempo real, habilita el streaming estableciendo stream: true en el cuerpo de tu petición. La API devuelve un flujo de Server-Sent Events (SSE) que contiene objetos delta. Cada delta contiene un fragmento del texto generado. Procesa estos fragmentos de forma incremental para mostrar el texto a medida que se genera, reduciendo la latencia percibida para los usuarios finales.
El manejo del flujo es idéntico al protocolo de streaming estándar de OpenAI. Debes manejar el evento de finalización del flujo para saber cuándo ha terminado la generación.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.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)
Llamadas a funciones
Define funciones en el cuerpo de tu petición usando el parámetro tools. El modelo puede devolver un objeto de llamada a herramienta en lugar de texto directo. Analiza el nombre de la función y los argumentos, ejecuta la función en tu código y luego envía los resultados de vuelta al modelo para una respuesta final. Esto permite que tu LLM interactúe con APIs o bases de datos externas de forma dinámica.
Las llamadas a funciones siguen el esquema estándar de OpenAI. Asegúrate de que las definiciones de tus funciones sean precisas para mejorar la precisión del modelo al seleccionar la herramienta correcta y extraer los argumentos.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.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);
Límites de la ventana de contexto
El modelo admite una ventana de contexto de 100.000 tokens, combinando tokens de prompt y de finalización. Monitorea el uso de tokens para evitar superar este límite, lo que resulta en un error 400 Bad Request. Si superas el límite de 300 peticiones por minuto, recibes un error 429 Too Many Requests.
Implementa reintento con backoff exponencial para los reintentos. Los cuerpos de las peticiones tienen un límite de 8 MB. Para conversaciones largas, considera resumir los mensajes anteriores para mantenerse dentro del presupuesto de tokens sin perder el contexto.
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)Funciones y límites
Todos los límites y funciones reales de la API en un solo lugar: revísalos antes de recargar.
| Elemento | Valor |
|---|---|
| Formato | compatible con OpenAI: cualquier SDK de OpenAI funciona cambiando la base URL y la clave |
| Autenticación | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| ID del modelo | uncensored |
| Llamadas a funciones | sí: tools, tool_choice; la respuesta trae tool_calls, también en streaming; resultados como role: tool |
| Modo JSON | response_format: {"type": "json_object"} |
| Salida máxima | hasta el resto de la ventana de 100.000 tokens; max_tokens opcional (sin límite aparte) |
| Ventana de contexto | 100.000 tokens (entrada + salida) |
| Parámetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sí: server-sent events; el último fragmento incluye el uso de tokens |
| Concurrencia | 8 peticiones a la vez por clave |
| Límite de peticiones | 300 por minuto por clave |
| Tamaño de petición | hasta 8 MB |
| Cabeceras | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Caducidad | el crédito pagado no caduca, sin suscripción |
| Bono | +5 % desde $50, +10 % desde $100, +15 % desde $200 |
| Recarga | USDT (TRC20) o USDC (Base), cualquier importe entero de $20 a $500 |
| Precio | $0,15 por 1M tokens de entrada · $0,50 por 1M de salida |
| Facturación | crédito prepago por uso real; errores y rechazos no se cobran |
| Prueba gratis | $0,50 durante 7 días, sin tarjeta · Clave de prueba: 2 solicitudes paralelas, 60 por minuto; límites completos (8 y 300) tras la primera recarga |
| Claves | una clave activa por cuenta; una nueva reemplaza a la anterior |
| Contenido | contenido adulto permitido; se rechaza el contenido sexual con menores |
| Acceso | Google o correo y contraseña |
Errores y qué hacer
Los errores llegan como JSON con un type fijo; las peticiones fallidas o rechazadas no se cobran.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensajes vacíos, parámetro incorrecto o contexto demasiado largo |
401 | missing_key · invalid_key · key_revoked | falta la clave, es incorrecta o fue reemplazada |
402 | no_credit | sin crédito: recarga y sigue al instante |
403 | content_blocked | contenido sexual con menores: rechazado, no se cobra |
404 | not_found | endpoint desconocido |
413 | request_too_large | cuerpo mayor de 8 MB |
429 | rate_limited · concurrency | más de 300/min o 8 en paralelo: espera y reintenta |
503 | upstream_busy | modelo ocupado: reintenta en unos segundos |
Preguntas y respuestas
¿Es esta API compatible con el SDK oficial de OpenAI?
Sí, es totalmente compatible. Solo necesitas cambiar la URL base y la clave de API en tu configuración existente del SDK de OpenAI para usar este servicio.
¿Qué ocurre si supero el límite de peticiones?
La API devuelve un error 429 Too Many Requests. Implementa lógica de reintento con retroceso exponencial para manejar esto de manera adecuada.
¿Puedo usar esta API para generación de imágenes?
No, esta API solo proporciona completados de texto. No admite endpoints de generación de imágenes, audio o video.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.