Guías de integración · 2026-10-06
APIs de LLM seguras para integrar sin compartir datos
Protege la integración con una clave en variable de entorno, límite de gasto, caducidad, ámbito de modelos y restricción de IP. Revisa el procesamiento TR y EU.
Respuesta corta: integra con controles sobre la clave
LLMTR (llmtr.com) es una pasarela que da acceso a modelos de lenguaje alojados en Turquía y en proveedores globales a través de una única API compatible con OpenAI. Para una integración, usa https://llmtr.com/v1, conserva la clave fuera del código y trata spending_limit_exceeded y model_not_allowed como señales de configuración que requieren revisar la clave y el modelo solicitado.
LLMTR no almacena los cuerpos de prompts ni respuestas; conserva metadatos del id del modelo, tokens, latencia, estado, coste en USD y los primeros 12 caracteres de la clave. La ubicación de procesamiento sigue siendo una decisión de integración: usa filas TR o EU según el lugar elegido y envía solo los campos necesarios.
APIs de LLM seguras para integrar sin compartir datos
Una API de LLM debe evaluarse por tres puntos: qué guarda, cómo se protege la clave y qué proveedor procesa cada solicitud. En LLMTR no se almacenan prompts ni respuestas; la clave admite límites de gasto, caducidad, hasta 50 modelos y hasta 20 IP o CIDR.
La clave sin formato se muestra una sola vez y LLMTR conserva únicamente su hash SHA-256. Debes mantenerla en una variable de entorno como LLMTR_API_KEY, nunca en código de navegador, y activar un límite de gasto, una caducidad y el ámbito de modelos adecuado para cada integración.
Controles sobre la clave API
Usa una clave por aplicación y entorno y revócala de forma independiente; no hay un límite fijo de claves activas. Toda clave que se ejecute sin supervisión debe tener un límite de gasto. Opcionalmente, define una caducidad, limita el ámbito a hasta 50 modelos y restringe el acceso a hasta 20 direcciones IPv4/IPv6 o rangos CIDR. Los cambios se aplican desde la siguiente solicitud; tras NAT o un proxy, registra la dirección pública de salida.
| Restricción | Qué hace | Al superarse |
|---|---|---|
| Límite de gasto (USD) | Limita el importe total que la clave puede gastar | 402 spending_limit_exceeded |
| Caducidad | Desactiva la clave después de 7, 30 o 90 días o de una fecha elegida | 401 auth_error |
| Ámbito de modelos | Limita la clave a modelos seleccionados (hasta 50) | 403 model_not_allowed |
| Restricción de IP | Limita la clave a direcciones IPv4/IPv6 y rangos CIDR indicados (hasta 20) | 403 permission_error |
Restricciones de la clave en código: 402 y 403
El ejemplo usa LLMTR_API_KEY, llama a https://llmtr.com/v1 y captura APIStatusError para imprimir el código y el tipo. Un 402 spending_limit_exceeded indica que se superó el límite de gasto; un 403 model_not_allowed indica que el modelo no está en el ámbito de la clave. Son señales de configuración, no errores transitorios: no los reintentes en un bucle. Un 403 permission_error señala que la dirección IP no cumple la restricción.
Este ejemplo de Python lee la clave del entorno y clasifica los errores de restricción.
import os
from openai import OpenAI, APIStatusError
# The key lives in an environment variable, never in source code or the browser.
client = OpenAI(base_url="https://llmtr.com/v1", api_key=os.environ["LLMTR_API_KEY"])
try:
reply = client.chat.completions.create(
model="llmtr/qwen3-8-27b",
messages=[{"role": "user", "content": "Draft a reply to this support ticket: ..."}],
)
print(reply.choices[0].message.content)
except APIStatusError as error:
# 402 spending_limit_exceeded, 403 model_not_allowed and 403 permission_error
# come from the restrictions set on the key.
print(error.status_code, error.response.json()["error"]["type"])
Mantener los datos en la ubicación elegida
Elige el id del modelo según dónde se procesará. Según su documentación, llmtr/qwen3-8-27b y llmtr/ornith-1-35b están alojados por LLMTR en Turquía. Para llmtr/ornith-1-35b, las solicitudes se procesan en servidores de LLMTR en Turquía y no se reenvían a un proveedor externo. La insignia TR indica la región de alojamiento; consulta la política de datos de cada página para conocer los detalles. Las filas con insignia EU de GreenPT se procesan dentro de la Unión Europea según el proveedor.
Aplica minimización de datos: envía solo los campos necesarios y enmascara los identificadores personales antes de la solicitud. Una clave de proveedor propia guardada en Settings se almacena cifrada en la base de datos y después se muestra únicamente enmascarada. La insignia del modelo indica su región de alojamiento, pero no determina por sí sola quién opera el servidor; revisa la política de datos de la página del modelo.
Empezar en LLMTR: cuenta, crédito, clave y primera solicitud
Paso 1: crea una cuenta en llmtr.com y verifica el correo electrónico. Paso 2: recarga crédito desde el Dashboard mediante el pago seguro. Se añade una sola vez un margen de plataforma del 8% sobre la recarga: 10,00 $ de crédito cuestan 10,80 $. El margen no forma parte de los precios de los modelos; cada llamada a la API se descuenta al precio de catálogo del modelo.
Paso 3: crea una clave API en Dashboard > API Keys. La clave sin formato se muestra una sola vez; guárdala en una variable de entorno como LLMTR_API_KEY. Paso 4: envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI, cambiando solo base_url y api_key. La página de uso del Dashboard muestra el uso y el gasto por clave. La misma clave y el mismo saldo sirven para todo el catálogo; cambia la cadena model para usar otro.
Integrar una API de LLM con una clave limitada
Crea una cuenta, recarga crédito, configura una clave con restricciones y completa la primera solicitud en https://llmtr.com/v1.
- Cuenta y verificación. Regístrate en llmtr.com y verifica el correo electrónico.
- Recarga de crédito. Recarga crédito desde el Dashboard mediante el pago seguro. El margen de plataforma del 8% se añade una sola vez: 10,00 $ de crédito cuestan 10,80 $. El margen no se añade a los precios de los modelos.
- Clave API. Crea una clave en Dashboard > API Keys. La clave sin formato se muestra una sola vez; guárdala en una variable de entorno como LLMTR_API_KEY.
- Primera solicitud. Envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI. Cambia únicamente base_url y api_key; la misma clave y el mismo saldo funcionan para todos los modelos del catálogo.
Frequently asked questions
¿La API de LLM almacena mis prompts y respuestas?
En LLMTR no se almacenan los cuerpos de prompts ni respuestas. Solo se conservan metadatos, incluidos los primeros 12 caracteres de la clave.
¿Cómo puedo limitar lo que hace una clave API filtrada?
Define un límite de gasto, caducidad, un ámbito de hasta 50 modelos y una restricción de IP de hasta 20 direcciones IPv4/IPv6 o rangos CIDR. Los errores asociados son 402, 401 o 403, según la restricción incumplida.
¿Qué significa 403 model_not_allowed?
El ámbito de modelos de la clave no incluye ese id. Solo permite los modelos seleccionados para esa clave.