Documentación de la API y MCP de EveryInfra

Autenticación

Envía la clave API como token Bearer. La autenticación se realiza antes de validar los parámetros: una solicitud sin clave válida recibe un 401, no detalles sobre los parámetros. No incluyas claves en código del navegador, registros ni repositorios públicos.

• Crea claves distintas para cada entorno o carga de trabajo.
• Rota una clave desde la consola si cambia su alcance o se ve expuesta.
• Aplica las restricciones de la consola para limitar una clave a líneas de producto, funciones o rangos de IP concretos.
• Con la misma clave, GET /api/v1/account te muestra el saldo (de pago, de bonificación y total), el descuento por recargas de este mes, el límite de solicitudes por minuto y el uso de las últimas 24 horas. Los importes están en USD. La consulta es de solo lectura, no tiene coste y no cuenta para el límite por minuto.
• En esa respuesta, balance.total_usd suma el saldo de pago y el de bonificación, y las llamadas consumen primero la bonificación. bonus_expiring muestra los importes de bonificación con fecha de caducidad que aún siguen vigentes. rate_limit.requests_per_minute lo comparten todas las claves de la cuenta, y usage_24h puede ir con un minuto de retraso aproximadamente.
• Para el historial de toda la cuenta (uso diario, llamadas recientes, facturación y movimientos del monedero), la misma clave puede leer la API de la consola, por ejemplo GET /portal/api/requests/{request_id}. La clave necesita acceso de lectura a la cuenta; estas lecturas no tienen coste y admiten 60 por minuto por cuenta. La lista completa está en la sección Account de la especificación OpenAPI.
• Para que una IA también pueda cambiar la cuenta, concede permisos de escritura en API Keys → Restringir acceso: gestionar claves, cambiar ajustes y abrir o responder tickets. Los tres están desactivados por defecto y solo tú puedes activarlos, con la sesión iniciada en la consola. Con una clave se pueden crear como máximo 20 claves y 10 tickets al día; ver o rotar claves completas, cambiar permisos o listas de IP permitidas, reactivar claves y los pagos siempre se hacen en la consola. La sección Account de la especificación OpenAPI lista los endpoints, por ejemplo POST /portal/api/keys/{key_id}/disable.
• Para no tener que consultar periódicamente, añade una dirección HTTPS en Configuración → Webhooks de la consola. Enviamos un POST firmado cuando el saldo baja hasta tu umbral o termina una tarea asíncrona. Verifica X-EveryInfra-Signature, un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo original calculado con tu secreto de firma; rechaza marcas de tiempo con más de 5 minutos de diferencia y elimina duplicados por el ID del evento, porque los envíos fallidos se reintentan con espera creciente, hasta 7 intentos.

curl https://api.everyinfra.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

API de IA (gratis con recarga)

La API de IA es chat/completions compatible con OpenAI. Cualquier cuenta con recarga la usa sin coste y sin consumir saldo para limpiar, quitar duplicados, clasificar, extraer y resumir los datos que recopila; el prompt define el formato de salida.

• Con el SDK de OpenAI, usa https://api.everyinfra.com/api/v1 como base_url y envía tu clave API de EveryInfra en la cabecera Authorization: Bearer; un ?key= en la URL se rechaza.
• El endpoint de chat es POST /api/v1/chat/completions, con el formato de solicitud y respuesta de OpenAI.
• Hay dos modelos: gemini-3.6-flash, el predeterminado, y gemini-flash-lite, más ligero. GET /api/v1/models devuelve la misma lista y no necesita clave. Un nombre de modelo mal escrito devuelve 422 con el nombre correcto más probable.
• Admite streaming: envía stream: true para recibir SSE que termina con data: [DONE] y añade stream_options.include_usage para el uso de tokens.
• messages admite hasta 45.000 caracteres en total; una entrada mayor devuelve 422 input_too_large, así que divídela en solicitudes más pequeñas.

from openai import OpenAI
import os

client = OpenAI(base_url="https://api.everyinfra.com/api/v1",
                api_key=os.environ["EVERYINFRA_API_KEY"])
reply = client.chat.completions.create(
    model="gemini-3.6-flash",
    messages=[{"role": "user", "content": "Devuelve solo JSON: indica el sentimiento, el tema y la intención de esta reseña."}],
)
print(reply.choices[0].message.content)

Límites según el total recargado, sumando todas las claves de la cuenta

El saldo de prueba y los códigos de crédito no cuentan en el total recargado; una cuenta que nunca ha recargado recibe 403 ai_topup_required. Los niveles son límites, no un rendimiento garantizado.

La API de IA sirve para organizar los datos que recopilas con EveryInfra. Si se usa para otra cosa o las llamadas son claramente anómalas, podemos pausar la API de IA de esa cuenta; la cuenta, sus demás API y su saldo no se ven afectados.

Comprende los cobros y los ajustes de saldo

Consulta en el catálogo público el precio y la unidad de facturación de cada función. Cada respuesta registra el importe cobrado. En los productos facturados por entrega correcta, un resultado fallido o vacío no deja un cargo final y cualquier importe reservado se restaura automáticamente.

• No conviertas unidades internas del saldo a moneda en tu cliente.
• Muestra la moneda y los importes devueltos por la API y úsalos para conciliar los cobros.
• Cuando una operación basada en entrega no se completa, cualquier importe reservado vuelve automáticamente al saldo de la cuenta.
• El objeto billing de cada respuesta de pago incluye charged_usd, lo que se cobró en esa llamada en USD (0 si no hubo cargo y null mientras el resultado aún no se conoce), y balance_after_usd, el saldo que queda una vez liquidada la llamada (null si no se puede leer). Durante un lote, sigue balance_after_usd en lugar de consultar la cuenta una y otra vez.
• Si una llamada falla y el importe reservado ya volvió a tu saldo, el billing del cuerpo del error también incluye balance_after_usd.