AI Gateway
Clave y límites
GET /v1/key en Clipia AI Gateway — nombre de la clave, uso en 30 días, saldo disponible y límite de solicitudes, además de las cabeceras de límite de frecuencia y la respuesta 429 para el chat con LLM.
GET /v1/key es un endpoint compatible con OpenAI que muestra qué clave está usando, cuánto ha gastado en los últimos 30 días, cuántos créditos tiene disponibles la cuenta y el límite de solicitudes de la clave. El coste de cada solicitud de chat se devuelve en su propia respuesta, en el campo usage.cost.
Información de la clave
/v1/keycurl https://api.clipia.ai/v1/key \
-H "Authorization: Bearer $CLIPIA_KEY"Respuesta 200
{
"data": {
"label": "prod key (····a1b2)",
"limit": null,
"usage": 1240.5,
"limit_remaining": 8320,
"is_free_tier": false,
"rate_limit": { "requests": 120, "interval": "1m" }
}
}Prop
Type
El mismo saldo, desglosado en créditos de suscripción y créditos comprados, lo devuelve GET /v1/account.
Coste de la solicitud
El coste de cada solicitud de chat en créditos se devuelve en el campo usage.cost de la respuesta. En modo streaming, pase stream_options: { "include_usage": true } y usage llegará en el último fragmento antes de data: [DONE]: consulte Chat Completions.
Aún no se puede consultar el coste por id
Por ahora no es posible consultar el coste de una solicitud completada por su id (chatcmpl-…). Guarde usage.cost de la respuesta si necesita contabilizar cada llamada. El gasto total de la clave en 30 días está en GET /v1/key, y el registro de solicitudes, en la pestaña Registros de la consola de desarrollador.
Límites
El chat con LLM está sujeto a los mismos límites que el resto de la API:
- 120 solicitudes por minuto por clave y 600 entre todas las claves de la cuenta;
- un límite de concurrencia, si se ha fijado para la clave o la cuenta;
- un límite de tokens por minuto y un presupuesto en créditos, solo si el equipo de Clipia los ha fijado; por defecto no hay ninguno.
Consulte Límites de frecuencia para más detalles.
Cabeceras de respuesta
Prop
Type
Respuesta 429
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json{
"error": {
"message": "API rate limit exceeded. Slow down and retry after the reset window.",
"type": "rate_limit_error",
"param": null,
"code": "rate_limit_exceeded"
}
}Respete Retry-After
Ante un 429, espere los segundos indicados en Retry-After antes de reintentar: es más fiable que un retardo fijo.
LangChain
Conecte Clipia AI Gateway a LangChain mediante ChatOpenAI con el base_url de Clipia — chat, llamadas a herramientas, agentes y salida estructurada sobre Claude, GPT y Gemini.
Use Clipia con agentes de IA
Ofrezca a los agentes de IA herramientas de vídeo, imagen, voz, música y presentaciones mediante Clipia MCP, o automatice la generación de imágenes y vídeos con la API REST.