---
title: "Restringir una clave de API de LLM a las IP de su servidor"
description: "Proteja sus claves de BroadNet Inference con listas de IP permitidas, separe claves de inferencia y credenciales del portal y revoque una clave filtrada en segundos."
url: https://broadrouter.com/es/guides/api-keys-ip-allow-lists/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/api-keys-ip-allow-lists/) (actualizado el 2026-11-16).

# Limite sus claves de API a sus servidores con listas de IP permitidas

Actualizado 2026-11-16

Agregue las direcciones IPv4 o IPv6 de salida de sus servidores, o rangos CIDR, a la lista de IP permitidas de la cuenta, hasta 32 entradas. Las claves nuevas heredan la lista salvo que pase allowed\_ips al crearlas. Las solicitudes desde otras direcciones reciben un 403, y los cambios en la lista o las revocaciones surten efecto en cinco segundos.

Una clave filtrada es la forma más común en que una factura de API se dispara. BroadNet Inference le ofrece dos controles: una lista de IP permitidas y la revocación rápida.

## Dos tipos de credencial

| Credencial | Úsela para | Trátela como |
| --- | --- | --- |
| Clave de inferencia | Solicitudes de modelos a `/v1/*` | Un secreto para una sola app o agente |
| Credencial del portal | Automatización de la cuenta: claves, IP permitidas, compras | Autoridad total sobre la cuenta |

Ambas se muestran una sola vez. El portal solo guarda un hash SHA-256, así que no puede volver a mostrar la clave. Una clave de inferencia de pago por uso dura un año desde su creación, y una cuenta puede tener hasta diez claves activas.

## Configure una lista de IP permitidas

En la página de la cuenta, agregue una dirección IPv4 o IPv6 o un rango CIDR por línea, hasta 32 entradas. Una lista vacía significa que no hay restricción de IP. Las claves nuevas heredan esta lista de la cuenta. El edge comprueba, en cada solicitud a la API, la IP del cliente que informa Cloudflare.

Para administrar la lista de la cuenta desde un script, `PUT /portal/allowed_ips` la reemplaza en una sola llamada (requiere credencial del portal).

Para darle a una clave su propia lista, indíquela al crearla con una credencial del portal:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

Un `allowed_ips` por clave reemplaza, para esa clave, la lista heredada de la cuenta. La respuesta contiene la clave en bruto una sola vez; guárdela de inmediato.

## Revoque rápido una clave filtrada

`DELETE /portal/keys/{alias}` revoca una clave de pago por uso, y `DELETE /portal/keys/hourly/{alias}` revoca una clave por hora (el cargo de la compra original se mantiene). Tras una revocación o un cambio en la lista de IP permitidas, las solicitudes nuevas se detienen en cinco segundos.

```bash
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
```

Asigne a `KEY_ALIAS` el alias que se muestra para la clave en la página de la cuenta o en `GET /portal/keys`. El alias no es la clave secreta. Si se filtra una credencial del portal, revóquela con `DELETE /portal/credentials/{id}`: puede hacer todo lo que puede hacer su cuenta.

## Solución de problemas

-   **403 desde un servidor que agregó a la lista.** El edge ve su dirección pública de salida, no la IP privada del servidor. Los servidores detrás de un gateway NAT, un proxy o un balanceador de carga salen con la dirección de ese dispositivo. Un servidor con IPv6 puede salir por IPv6 aunque usted solo haya agregado su dirección IPv4. Agregue la dirección desde la que realmente sale la solicitud, o un rango CIDR que la cubra.
-   **Una clave nueva ignora la lista de la cuenta.** Un arreglo `allowed_ips` por clave reemplaza, para esa clave, la lista heredada de la cuenta. Revise lo que pasó al crearla.
-   **409 `key_limit_reached`.** La cuenta ya tiene diez claves activas. Revoque una que ya no use.
-   **Las solicitudes siguen funcionando unos segundos después de revocar.** Es lo esperado durante un máximo de cinco segundos, mientras la caché se actualiza.

Una solicitud desde una dirección que no está en la lista recibe un 403. Consulte [todos los códigos de error de BroadNet y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/). Para hacer su primera solicitud con una clave nueva, siga [la guía del SDK de OpenAI para Python](https://broadrouter.com/es/guides/openai-python-sdk/). La [entrada del glosario sobre listas de IP permitidas](https://broadrouter.com/es/glossary/ip-allow-list/) explica la idea en términos generales.

_[image: A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."]_

## Términos de esta guía

[Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/)

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

[Lista de IP permitidas (IP allow list)](https://broadrouter.com/es/glossary/ip-allow-list/)

Una lista de IP permitidas es un control de seguridad que solo acepta solicitudes de direcciones IP o rangos CIDR incluidos en ella y rechaza todas las demás. En una API, limita el daño de una clave filtrada, porque la clave no funciona desde redes que no estén en la lista.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

## Preguntas frecuentes

### ¿Cómo restrinjo una clave de API de LLM a la dirección IP de mi servidor?

Agregue la dirección pública de salida del servidor, o un rango CIDR, a la lista de IP permitidas en la página de su cuenta de BroadNet, o pase allowed\_ips al crear la clave con POST /portal/keys. Las solicitudes desde cualquier otra dirección se rechazan con un 403.

### ¿Una lista vacía lo bloquea todo?

No. Una lista vacía significa que no hay restricción de IP, así que la clave funciona desde cualquier dirección. Agregue al menos una entrada para activar la restricción.

### ¿Puedo usar una clave de inferencia para crear otras claves?

No. Las claves de inferencia solo llaman a las rutas de modelos /v1/\*. Crear y revocar claves, cambiar las IP permitidas y comprar claves por hora requiere una credencial del portal, que tiene autoridad total sobre la cuenta.

### ¿Qué tan rápido surte efecto revocar una clave filtrada?

La documentación de BroadNet dice que las solicitudes nuevas se detienen dentro de los cinco segundos posteriores a una revocación o a un cambio en la lista de IP permitidas, porque las decisiones de autorización pueden permanecer ese tiempo en una caché replicada.

## Guías relacionadas

-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de la API de BroadNet Inference, listas de IP permitidas (consultada el 2026-11-16) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [Referencia de la API de BroadNet Inference, claves por hora y credenciales del portal (consultada el 2026-11-16) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [Referencia de la API de BroadNet Inference, límites (vigencia de las claves y claves activas) (consultada el 2026-11-16) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
