FRELY / Preguntas frecuentes
Uso de modelos y claves de API
Claves de API, configuración del cliente, uso y qué hacer cuando una solicitud falla.
Las herramientas de la cuenta están disponibles desde una aplicación de IA conectada a FrelyMCP (https://mcp.frely.cloud/mcp, mediante frely_list y frely_call) o desde una terminal con el Frely CLI: frely api describe <tool> y luego frely api call <tool>. Las herramientas que modifican algo requieren tu aprobación en el sitio de Frely.
01
¿Cómo creo una clave de API?
Abre la página de claves de API en tu consola y crea una. Una clave autoriza llamadas a modelos, no acciones de administración. Guárdala en la configuración protegida de tu cliente. Nunca la coloques en Git, capturas de pantalla ni chats. Revocar una clave detiene su uso posterior.
Herramientas de API: keys.listkeys.createkeys.set_limits
02
¿Cuál es la URL base de la API de Frely?
https://api.frely.cloud. Usa siempre https: las solicitudes por http sin cifrar se rechazan, así que un cliente configurado con http://api.frely.cloud fallará. La misma dirección sirve para todos los protocolos, por ejemplo https://api.frely.cloud/v1/chat/completions, /v1/responses, /v1/messages, /v1/embeddings y la lista de modelos en /v1/models. Algunos clientes esperan que la URL base lleve /v1 al final (https://api.frely.cloud/v1) y agregan la ruta del endpoint por su cuenta.
Herramientas de API: models.available
03
¿Cómo autentico las solicitudes a la API?
Envía tu clave de API como token bearer: Authorization: Bearer <tu clave>. Agrega Content-Type: application/json a las solicitudes con cuerpo. Una solicitud sin una clave válida recibe un 401. Una clave autoriza solo llamadas a modelos, no la administración de la cuenta.
Herramientas de API: keys.listkeys.create
04
¿Qué aspecto tiene una respuesta de error?
Un cuerpo JSON con la forma {"error":{"message","type","param","code"}}. El tipo sigue el estado HTTP: 401 authentication_error, 402 insufficient_quota, 403 permission_error, 404 not_found_error, 408 o 504 timeout_error, 429 rate_limit_error, otros 4xx invalid_request_error, 503 service_unavailable_error, otros 5xx server_error. Cada respuesta incluye un encabezado x-request-id; consérvalo al contactar a soporte. Una falla reintentable puede incluir un encabezado Retry-After en segundos.
Herramientas de API: request_history.list
05
¿Qué coloco en mi app de IA o cliente?
Tres valores: la dirección pública del servicio para el protocolo que elegiste (no una dirección interna), tu propia clave de API y un nombre de modelo público que tu cuenta pueda ver. Las instrucciones de tu cuenta muestran los valores exactos.
Herramientas de API: models.availablekeys.list
06
¿Cómo agrego Frely a Claude o ChatGPT?
Agrega Frely como connector (conector), usa la dirección de FrelyMCP como URL del servidor MCP, elige OAuth, inicia sesión en Frely y aprueba el acceso. Las guías paso a paso muestran cada pantalla.
07
Un modelo aparece en la lista, pero no puedo llamarlo.
Estar en la lista no es permiso para llamarlo. Verifica tu plan, saldo, asignación y los términos del servicio, y consulta a un administrador autorizado si estás en un Team. Rotar claves no sirve para evitar una restricción.
Herramientas de API: models.availablebudget.getcredits.account
08
Mi solicitud falló o se agotó el tiempo de espera.
Guarda una nota sin información sensible con la hora, el protocolo, el nombre del modelo y el ID de la solicitud, y consulta tu historial de solicitudes. Un timeout o una conexión interrumpida no demuestran que no se haya usado nada, así que verifica el uso antes de reintentar. No envíes credenciales, cuerpos de solicitud ni volcados de error sin procesar a nadie.
Herramientas de API: request_history.listusage.summary
09
¿Puedo confiar en la salida de un modelo?
La salida de un modelo puede contener errores y Frely no garantiza su exactitud. Revísala antes de usarla en entornos críticos para la seguridad, legales, financieros, médicos, de seguridad o de producción.