Autenticación
Claves de API
Las solicitudes de inferencia se autentican con una clave de API de MartLLM. Las claves comienzan con ull_
seguido de un sufijo aleatorio. Pásala como un token de portador:
Authorization: Bearer ull_your_key_here
La superficie de Anthropic también acepta la clave en el encabezado x-api-key.
Tu primera clave se genera para ti en tu primera visita al panel de control y se muestra allí con una primera llamada que puedes pegar. Crea, edita, lista y elimina claves en Panel de control → Claves de API. El secreto completo se muestra una única vez al crearse — guárdalo inmediatamente; MartLLM solo guarda un hash y nunca podrá mostrarlo de nuevo. Eliminar una clave (Panel de control → Claves de API → Eliminar) surte efecto de inmediato: las aplicaciones que la usan dejan de funcionar, y su uso anterior permanece en tus totales.
Controles por clave
Cada clave puede tener sus propias salvaguardas, configuradas al crearla o más tarde con Editar en Panel de control → Claves API. Un cambio se aplica a la siguiente solicitud de la clave.
- Límite de gasto — un tope en USD durante un período de
daily,monthlyolifetime. Las solicitudes que lo excedan son rechazadas con402 key_spend_cap_exceeded. Vacío significa sin límite. - Límite diario —
daily_limit_usd, además del límite de gasto. Una solicitud debe ajustarse a ambos, y el límite diario se restablece a medianoche UTC. Una solicitud que supere cualquiera de los límites es rechazada con402 key_spend_cap_exceededy no se cobra nada. Configúralo en la página de Claves o conPATCH /api/v1/keys/{id}. - Límite de tasa — un tope de solicitudes por minuto (1 a 10,000). Vacío significa el límite estándar por clave (300 por minuto).
- No guardar mis solicitudes y respuestas — desactivado por defecto: MartLLM guarda cada solicitud y su respuesta durante 90 días para corregir solicitudes fallidas y responder preguntas de soporte. Actívalo y las llamadas realizadas con la clave no se guardarán. Solo guardamos el registro de cada llamada (hora, modelo, recuento de tokens, costo, la dirección de origen, los proveedores que intentamos y cualquier error que devolvieron), no lo que enviaste o lo que recibiste, por lo que no podemos investigar una respuesta incorrecta por ti. Los trabajos de vídeo y música aún conservan su solicitud, por lo que un trabajo que un proveedor abandona puede iniciarse de nuevo. El proveedor que atiende una solicitud la recibe de cualquier manera. Configúralo en la página de Claves, o con
no_store(true/false) enPOST /api/v1/keysyPATCH /api/v1/keys/{id};GET /api/v1/keyslo devuelve. - Proveedor BYOK — asocia la clave para enrutarla a través de tu propia credencial de proveedor (ver abajo).
Correo electrónico de saldo bajo
En Dashboard → Créditos puedes solicitar que se te envíe un correo electrónico cuando tu saldo caiga por debajo de una cantidad que elijas. Está desactivado por defecto, envía un correo electrónico cada vez que el saldo cae por debajo de esa cantidad y se envía a los propietarios de la cuenta. Si el dinero reservado para una solicitud de imagen, video, música o voz aún está retenido 15 minutos después de que el trabajo haya terminado, los propietarios de la cuenta reciben un correo electrónico con la lista de esos trabajos y se informa a nuestro equipo. Ese dinero sigue siendo tuyo y será liberado.
BYOK — trae tu propia clave
Añade una credencial de proveedor en Dashboard → BYOK. Las solicitudes enrutadas a través de un proveedor BYOK usan tu credencial directamente; no se reservan créditos y el costo por token es cero en tu saldo de MartLLM. Las credenciales almacenadas están cifradas y solo se muestran como un último-4 enmascarado.
Sesiones del panel de control
Inicias sesión en el panel de control web con Google (un clic: el mensaje "Continuar como"
en martllm.com, o el botón de Google), o con tu correo electrónico: enviamos un
código de 6 dígitos (y un enlace para iniciar sesión) que caduca en 15 minutos. No hay
contraseña. Al iniciar sesión se genera una sesión de corta duración, almacenada en una cookie httpOnly. Esta sesión es independiente de tus
claves de inferencia ull_ — los endpoints del panel de control bajo /api/v1/* usan la cookie;
la pasarela (/v1/*) usa la API key.
Errores
Los fallos de autenticación devuelven un sobre de error al estilo OpenAI:
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
Consulta Errores y límites para ver la lista completa.