Configura tu cuenta

Crea tu cuenta y verifica tu correo

Abre spicyapi.ai/register. Hay tres formas de registrarse:

Marca la casilla de aceptación de los términos del servicio y la política de privacidad, y elige Crear cuenta.

Qué deberías ver: en una cuenta con correo, una página titulada Revisa tu bandeja de entrada. Abre el correo y haz clic en el enlace. La página Correo verificado lo confirma, e Ir a la consola te lleva dentro.

Qué acaba de pasar: tu cuenta ya existe, pero solo puede llamar a la API cuando el correo esté verificado. Hasta entonces, la consola muestra el aviso Correo sin verificar: las llamadas a la API están bloqueadas.

• El enlace funciona una sola vez y caduca a las 24 horas. Si ha caducado, ábrelo igualmente y usa Enviar un enlace de verificación nuevo, o elige Verificar en el aviso de la consola.
• ¿No ha llegado nada después de unos minutos? Revisa la carpeta de spam y usa Enviar otra vez.

Añade saldo

Abre Facturación en la consola: spicyapi.ai/console/billing. En Añadir saldo:

1. Elige un importe. Escoge uno de los importes predefinidos (por ejemplo $10, $25, $50 o $100) u Otro importe y escribe el tuyo. La consola muestra el importe mínimo y el máximo que puedes añadir en un solo pago. Los pagos en línea admiten como máximo dos decimales.
2. Busca una bonificación. Algunos importes incluyen una bonificación promocional, que se muestra como +$… de regalo antes de pagar. La bonificación se añade como un movimiento aparte, junto al importe que pagaste.
3. Elige una vía de pago y sigue la pestaña correspondiente.

Otros mensajes que puedes ver:

• Recarga no disponible o Ahora mismo no se puede crear una orden de recarga: las recargas están cerradas temporalmente o tienes demasiadas órdenes pendientes. Completa o cancela las antiguas en Órdenes de recarga, o vuelve a intentarlo más tarde.
• Se cortó la conexión y no sabemos el resultado: revisa Órdenes de recarga antes de volver a intentarlo, para no pagar dos veces.

Opcional: activa la recarga automática

La recarga automática cobra por ti una tarjeta guardada cuando tu saldo baja, para que los trabajos largos no se detengan a mitad con 40201. Solo funciona con tarjeta.

1. En Facturación, busca Recarga automática y elige Guardar método de pago de forma segura.
2. Introduce tu tarjeta en la página segura que se abre. Los datos de la tarjeta se quedan en el procesador de pagos.
3. De vuelta en Facturación verás Estamos comprobando tu método de pago y después Método de pago guardado. Si ves Esta tarjeta no se puede usar aquí, no se guardó nada; prueba con otra tarjeta.
4. Rellena tres campos:
   • Recargar por debajo de: el saldo que dispara un cobro.
   • Importe por recarga: cuánto añade cada cobro. Tiene que estar dentro del mismo intervalo que una recarga normal.
   • Límite mensual: lo máximo que la recarga automática puede cobrar en un mes natural. No puede ser inferior al importe por recarga.
5. Marca la autorización y elige Activar la recarga automática.

Qué deberías ver: La recarga automática queda activa con estos límites. La tarjeta muestra la regla, por ejemplo «Recarga $50 en cuanto tu saldo baja de $10», y Usado este mes.

Las reglas, con exactitud:

• Comprobamos tu saldo con una frecuencia de entre 30 segundos y 2 minutos, aproximadamente. Cuando tu saldo disponible es igual o inferior al umbral, cobramos el importe fijado en la tarjeta guardada.
• Cada cobro es una orden de recarga normal con la etiqueta Automática. Recibe la misma bonificación que una recarga manual del mismo importe, y puedes emitir una factura por ella.
• El límite mensual cuenta meses naturales en UTC. Cuando se agota, la recarga automática espera hasta el día 1 del mes siguiente. Los cobros fallidos no cuentan para el límite.
• Si un cobro falla, lo volvemos a intentar al cabo de 1 hora y otra vez al cabo de 6 horas. Si el tercer intento seguido también falla, la recarga automática se desactiva sola. Si el banco rechaza la tarjeta de forma definitiva (por ejemplo, una tarjeta robada o cancelada), se desactiva de inmediato. Un cobro correcto reinicia la cuenta.
• Después de que se haya desactivado sola, arregla la tarjeta (o guarda otra) y vuelve a activarla.
• Desactivar la recarga automática detiene los cobros futuros en cualquier momento. Nunca modifica tu saldo ni las recargas que ya se hicieron.

Crea una clave de API

Abre Claves de API: spicyapi.ai/console/keys y elige Crear clave (o Crear la primera clave).

En el cuadro de diálogo Crear una clave de API solo es obligatorio el nombre. Todo lo que hay en Avanzado se puede cambiar más adelante.

Nombre. Ponle a la clave el nombre de lo que la va a usar, como production backend o my laptop. Tendrás que reconocerla cuando la revoques. Hasta 120 caracteres.

Límites de gasto (en Avanzado, en dólares estadounidenses). Cuando se alcanza un límite, esta clave rechaza las tareas nuevas con 40202 hasta que empieza el siguiente periodo. Tus demás claves siguen funcionando. El dinero retenido para tareas que aún están en marcha cuenta para todos los límites.

Escribe 0 en cualquier límite para no poner límite; dejarlo en blanco significa lo mismo.

Acceso.

• Modelos permitidos. Si lo dejas en Todos los modelos (sin restricción), la clave puede llamar a todos los modelos, incluidos los que se añadan más adelante. Si eliges modelos concretos, la clave rechaza cualquier otro modelo con 40301.
• IP permitidas. Cualquier dirección acepta llamadas desde cualquier sitio. Solo estas acepta llamadas únicamente desde las direcciones que indiques: IPv4, IPv6 o rangos CIDR como 203.0.113.10, 198.51.100.0/24, separados por comas, hasta 64 entradas. Usa la dirección pública desde la que llama tu servidor, no una dirección de la red interna de tu oficina o tu casa. Las llamadas desde cualquier otro sitio se rechazan con 40302. En un portátil, cuya dirección cambia, déjalo en Cualquier dirección.
• Caducidad. Elige 7, 30 o 90 días, 1 año, Nunca o una fecha exacta. La clave deja de funcionar al final de ese día, en UTC, y a partir de entonces recibe el mismo 401 que una clave revocada.

Elige Crear clave.

Qué deberías ver: un cuadro de diálogo Clave creada con la clave completa, que empieza por sk-spicy-. Cópiala con Copiar la clave o elige Guardar como archivo. Marca Ya guardé esta clave en un lugar seguro y después Listo.

Qué acaba de pasar: esta es la única vez que se muestra la clave completa. Solo guardamos un hash irreversible de ella, así que nadie, tampoco nuestro equipo de soporte, puede volver a mostrártela. Si la pierdes, revócala y crea otra.

Más adelante, en la misma página:

• Editar cambia el nombre, los límites, los modelos permitidos, las IP permitidas y la caducidad. Los cambios se aplican al momento.
• Revocar detiene la clave de inmediato y no se puede deshacer. Las tareas que ya se habían aceptado siguen ejecutándose y se cobran igualmente.
• Puedes tener hasta 50 claves activas en un mismo ámbito. Usa una clave por aplicación o por entorno, para poder revocar una sin detener las demás.

Guarda la clave en SPICY_API_KEY

Una variable de entorno es un valor con nombre que tu terminal entrega a los programas que inicia. El SDK, la CLI y el servidor MCP oficiales, y todos los ejemplos de esta documentación, leen tu clave de una variable llamada SPICY_API_KEY. Así la clave nunca tiene que escribirse dentro de un comando ni guardarse dentro de un proyecto.

Primero abre una terminal: en macOS, pulsa Cmd + barra espaciadora, escribe Terminal y pulsa Enter. En Windows, abre el menú Inicio, escribe PowerShell y abre Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

En un servidor, define SPICY_API_KEY en los ajustes de secretos o de entorno de tu proveedor de hosting, en lugar de en un archivo dentro de tu proyecto.

Haz una llamada de prueba gratuita

Esta llamada consulta tu saldo. No cuesta nada, no crea nada y demuestra tres cosas a la vez: que la clave está configurada, que la clave es válida y que tu cuenta tiene permiso para llamar a la API.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Resultado esperado: una respuesta como esta (abreviada):

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

Qué significa: "code": 200 es éxito. Los importes están en dólares estadounidenses, escritos como texto. available es lo que puedes gastar en generaciones nuevas, held es lo retenido para generaciones que siguen en marcha y total es la suma de los dos. La respuesta real incluye también un objeto funding que separa los fondos pagados de los posibles bonos promocionales; por ahora puedes ignorarlo.

Si recibes otra cosa:

¿Prefieres no usar curl? La CLI hace lo mismo con spicyapi balance.