Documentación de la API
Una clave y un endpoint compatible con OpenAI para todos los modelos del catálogo. Aquí se explica cómo conectarse, qué devuelve cada endpoint, en qué se mide el consumo y qué significan los códigos de error.
Inicio rápido
- Cree una clave API en el panel, sección «Claves API». El secreto se muestra una sola vez: guárdelo.
- Configure la URL base y la cabecera de autorización en su cliente.
- Envíe una petición al endpoint que necesite: el consumo se descuenta del saldo automáticamente.
curl https://llmall.store/v1/chat/completions \
-H "Authorization: Bearer sk-llmall-..." \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{ "role": "user", "content": "Hola" }]
}'URL base y autenticación
URL base: https://llmall.store/v1. Compatible con el SDK de OpenAI: basta con cambiar base_url.
El secreto se envía en la cabecera Authorization con el esquema Bearer. La clave se puede pausar o revocar en cualquier momento; la revocación surte efecto en la puerta de enlace de inmediato.
Endpoints
| Endpoint | Qué hace | Estado |
|---|---|---|
| POST /chat/completions | Chat compatible con OpenAI; admite respuesta en streaming | funciona |
| POST /messages | Chat en el formato Anthropic Messages API | funciona |
| GET /models | Modelos disponibles para su clave según su política | funciona |
| POST /embeddings | Vectores de texto | funciona si el modelo tiene proveedor configurado |
| POST /images/generations | Generación de imágenes | funciona si el modelo tiene proveedor configurado |
| POST /audio/speech, /audio/transcriptions | Síntesis y reconocimiento de voz | funciona si el modelo tiene proveedor configurado |
| POST /videos/generations | Generación de vídeo | funciona si el modelo tiene proveedor configurado |
Algunos modelos del catálogo no tienen proveedor configurado y responden con un resultado simulado (en embeddings, un vector de relleno). El consumo de CU se cobra igualmente. Compruebe el modelo concreto antes de usarlo en producción.
En qué se mide el consumo
La unidad es CU (1 CU = 10 USD de coste estimado). Los modelos se facturan por 1K o 1M de tokens, por embedding, por imagen, por segundo de vídeo o por petición: la unidad aparece en la ficha del modelo.
Los precios del catálogo se muestran en rublos y en CU. Los precios de modelos usan el tipo del banco central; la recarga usa un tipo con el recargo del canal de pago, por lo que el importe a pagar por el mismo volumen es mayor. La diferencia se ve en la caja antes de confirmar.
Recarga: SBP mediante código QR o tarjeta bancaria. Mínimo 1 CU.
Límites
Los límites mensual y diario por clave son opcionales: si se dejan vacíos no hay tope y el gasto queda limitado por el saldo de la cuenta. Si se define el mensual y tienes plan, no puede superar el mensual del plan.
La frecuencia de peticiones se limita en el lado de la plataforma. Al superarla se devuelve 429 con la cabecera Retry-After: los segundos que hay que esperar.
Códigos de error
| Código | Significado | Qué hacer |
|---|---|---|
| 400 / 422 | Petición incorrecta: cuerpo mal formado o campo desconocido | Revise el JSON y los nombres de campo |
| 401 | Clave ausente, revocada o no válida | Revise la cabecera Authorization |
| 403 | Modelo prohibido por la política de la clave | Quite el modelo o cambie la política |
| 404 | Ruta desconocida o modelo no encontrado | Consulte la lista de endpoints y GET /models |
| 429 insufficient_cu | Saldo o presupuesto de la clave agotado | Recargue o suba el límite de la clave |
| 429 rate_limit_exceeded | Frecuencia de peticiones superada | Espere Retry-After segundos y reintente |
| 500 | Error interno de la puerta de enlace | Reintente más tarde; si persiste, escriba a soporte |
| 503 provider_unavailable | El proveedor del modelo no está disponible | Reintente más tarde o use otro modelo |
Qué se configura en el panel
Claves: nombre, límite mensual y diario en CU (opcional), pausa y revocación. El secreto se muestra una sola vez al crearla.
Recarga: importe en CU o en rublos, método de pago (QR de SBP o tarjeta). Mínimo 1 CU.
Perfil: nombre, cambio de contraseña, cuentas de inicio de sesión vinculadas (Google, Yandex ID).
Combos: su propio conjunto de modelos bajo un nombre; la petición va al miembro más barato disponible y, si está ocupado, al siguiente por precio.
Suscripción «Enmascaramiento de datos»: antes de reenviar al proveedor detectamos nombres, teléfonos, correos, pasaportes, СНИЛС/ИНН rusos y números de tarjeta, los sustituimos por marcas y restauramos los originales en la respuesta. La correspondencia entre marcas y valores vive solo en memoria del proceso y nunca se guarda.
Si no funciona
- 401 — compruebe que la clave esté completa, sin espacios ni saltos de línea.
- 403 — el modelo está bloqueado por la política de esta clave, no por la de la cuenta.
- 429 con insufficient_cu y 429 con rate_limit_exceeded son causas distintas; revise el campo type.
- Respuesta vacía o inesperada en un endpoint que no es de chat — el modelo no tiene proveedor configurado, la respuesta fue simulada.
- Modelo no encontrado — consulte GET /models: la lista respeta la política de su clave.