# Agentes de IA

Source: https://ipvolt.com/es/docs/ai-agents
Markdown: https://ipvolt.com/es/docs/ai-agents.md
Language: es

[Inicio](https://ipvolt.com/es.md) / [Documentación (en inglés)](https://ipvolt.com/docs.md) / Agentes de IA

Sección: API
Actualizado: 2026-11-22
Autor: ipvolt

Cómo un agente de IA alquila un proxy móvil por un día o 30 días, rota su IP y amplía el alquiler con tu saldo prepago, con una clave de API y un límite diario.

Un agente de IA puede recorrer todo el ciclo por sí mismo a través de la [API](/es/docs/api): consultar las ofertas, añadir saldo con sus propios USDC, alquilar un proxy móvil dedicado por 1 o 30 días, obtener los datos de conexión, rotar su IP y ampliar el alquiler. Lo configuras una vez con una clave de API; después no necesita el panel.

- URL base de la API: `https://ipvolt.com/beta/api/v1`
- Dirección de pago para recargas: `https://ipvolt.com/api/v1`
- [Referencia de la API](/es/docs/api), [descripción OpenAPI](https://ipvolt.com/beta/api/v1/openapi.json) y [configuración de Proxy Toolkit MCP (en inglés)](/mcp)

## El ciclo

1. **Consultar las ofertas:** `GET /stock`, sin clave.
2. **Añadir saldo:** `GET /fund?amountMinor=N` responde `402` con una oferta. El agente firma una transferencia de USDC en Base, la envía con su clave y consulta `statusUrl` hasta que el pago queda `credited`, normalmente en pocos minutos. De US$1 a US$500 por recarga; los detalles están en «Añadir saldo desde tu agente» de la [referencia de la API](/es/docs/api).
3. **Alquilar:** `POST /rentals` con una `Idempotency-Key` y lo máximo que puede pagar por dispositivo en `maxPriceMinor`, y luego `GET /orders/{orderId}` mientras el pedido esté en `paid`.
4. **Obtener los datos de conexión:** cuando el pedido está `fulfilled`, `GET /rentals/{id}` da el host, los puertos, el usuario y la contraseña del proxy.
5. **Rotar:** `POST /rentals/{id}/rotate` pide una IP nueva.
6. **Ampliar:** `GET /rentals/{id}/extension-price` y luego `POST /rentals/{id}/extend` con una `Idempotency-Key` y `maxPriceMinor`.

Alquilar y ampliar gastan el saldo y cuentan para el límite diario de la clave. Una recarga gasta los USDC del propio agente, nunca el dinero del cliente, y no se reembolsa en la cadena: queda como saldo.

## Configúralo una vez

1. En **Account settings → API keys** del [panel](https://ipvolt.com/dashboard), crea una clave de lectura y escritura, con una caducidad de 30 o 90 días y un límite diario. Copia la clave: solo se muestra una vez.
2. Da la clave al agente en la variable de entorno `IPVOLT_API_KEY`, nunca en un prompt.
3. Para las recargas, dale una cartera con USDC en Base, con la clave privada también en su entorno. También puedes añadir saldo tú mismo en el panel.

Una clave de solo lectura permite al agente mirar sin gastar. La [referencia de la API](/es/docs/api) tiene todos los endpoints, los errores y ejemplos en cURL, Python y Node.js, uno de ellos una recarga seguida de un alquiler.

## Proxy Toolkit MCP

Ejecutado en local, el servidor [Proxy Toolkit MCP (en inglés)](/mcp) añade herramientas de cuenta cuando `IPVOLT_API_KEY` está definida en su entorno; usan la API con esa clave. Sin la variable, el servidor local no tiene herramientas de cuenta, y el servidor alojado en `https://mcp.ipvolt.com/mcp` mantiene sus cuatro herramientas, que no necesitan clave.

```json
{
  "mcpServers": {
    "ipvolt-proxy-toolkit": {
      "command": "npx",
      "args": [
        "--yes",
        "@ipvolt/proxy-toolkit-mcp@0.3.0"
      ],
      "env": {
        "IPVOLT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

La configuración contiene la clave, así que mantén el archivo privado. Para probar las herramientas antes de tener una cuenta, define `IPVOLT_SANDBOX` con el valor `1` en lugar de la clave: entonces funcionan sobre una cuenta simulada dentro del servidor local, no envían ninguna petición a ipvolt y no cobran nada.

## Sin cuenta

Un agente también puede alquilar un proxy móvil dedicado sin una cuenta de ipvolt. Crea un pedido con `POST /guest/orders`, aceptando los Términos, y recibe una sola vez un ID de factura (invoice ID). Paga con sus propios USDC en la dirección de pago de arriba, enviando el ID de factura en la cabecera `Authorization`, y después alquila con `POST /rentals`. `GET /guest` indica los pasos, la versión de los Términos y los límites. El ID de factura es la única forma de volver al pedido: el agente debe mantenerlo en secreto y a salvo. Un paquete de tráfico funciona igual: el pedido indica su `packId` y `POST /traffic/purchase` lo compra con el saldo del pedido.

## Tokens de agente

Un agente también puede obtener acceso con [auth.md](https://ipvolt.com/auth.md) en lugar de una clave: lo confirmas con un código de 6 dígitos y eliges acceso de solo lectura o un límite de gasto.

La [Política de uso aceptable (en inglés)](/acceptable-use) se aplica a todo lo que un agente hace a través de la API.

## Más documentación

- Siguiente: [Facturación y renovaciones (en inglés)](https://ipvolt.com/docs/billing.md)
- [Toda la documentación (en inglés)](https://ipvolt.com/docs.md)
- [Leer el original en inglés](https://ipvolt.com/docs/ai-agents.md)
