Consola y espacios de trabajo

La consola, en spicyapi.ai/console, es donde gestionas tu cuenta desde el navegador: dinero, claves de API, registros, compañeros de equipo y ajustes. Tus propios programas nunca usan la consola: llaman a la API con una clave de API.

¿Acabas de llegar? Sigue primero Configura tu cuenta, que te lleva en orden por el registro, la recarga de saldo y la creación de una clave. Esta página es la referencia de todo lo demás que hay en la consola.

Cómo orientarte

Arriba, en todas las páginas: tu Saldo con el botón Recargar, Modelos, Documentación, la campana de notificaciones y Buscar página (pulsa ⌘K en macOS o Ctrl + K en Windows y Linux, y escribe el nombre de una página de la consola).

A la izquierda, la barra lateral. Arriba del todo está el selector de ámbito, que decide qué cuenta o qué equipo estás viendo (consulta Ámbito personal y equipos). Debajo, las páginas están agrupadas:

En el móvil, abre la barra lateral con el botón de menú.

Las páginas de la consola de un vistazo

Todas las direcciones empiezan por https://spicyapi.ai. Las direcciones de la consola no llevan prefijo de idioma.

Qué hace cada página

Resumen

La primera página que ves al iniciar sesión.

• La lista Primeros pasos: Verificar tu correo, Añadir fondos y Ejecuta tu primera tarea, además de enlaces para desarrollar con la API o para crear sin código. Cuando hayas terminado, escóndela con Ocultar primeros pasos.
• Saldo disponible, con el importe retenido para tareas que siguen en marcha y lo que gastaste en los últimos 7 días.
• Solicitudes de los últimos 7 días y Errores de los últimos 7 días, con enlaces a Ver uso y Ver registros.
• Modelos usados recientemente y Tareas recientes.
• Un aviso cuando el saldo es bajo o está a cero. Con el saldo a cero, las tareas nuevas se rechazan hasta que recargues; las que ya se habían aceptado terminan igualmente.

Facturación

Facturación tiene tres pestañas: Resumen, Consumo y Facturas.

Facturación → Resumen (/console/billing)

• Añadir saldo con tarjeta, con criptomonedas o, cuando se ofrece, por transferencia manual. Las instrucciones paso a paso, los plazos y qué hacer si un pago no aparece están en Configura tu cuenta → Añade saldo.
• Órdenes de recarga: cada recarga con su estado (Pendiente, Pagada, Cancelada o Reembolsada). Abre una orden manual pendiente con Completar el pago para ver sus instrucciones de pago y enviar la referencia de tu transacción, o usa Cancelar orden pendiente si todavía no has pagado.
• Recarga automática: guarda una tarjeta y deja que recarguemos cuando el saldo baje. Las reglas exactas, incluido qué pasa cuando un cobro falla, están en Configura tu cuenta → Recarga automática.
• Detalle del saldo: solo aparece si tu cuenta tiene bono promocional o crédito aprobado. Muestra cada lote de bono promocional con su fecha de caducidad.
• Historial del saldo: cada movimiento de dinero, del más reciente al más antiguo. Puedes filtrar por tipo y por intervalo de fechas, o usar Exportar CSV. Los movimientos habituales son Recarga, Bonificación, Apartado (el importe retenido cuando se acepta una tarea), Cobrado (el precio final de una tarea que salió bien), Importe liberado (la parte de la retención que no se usó) y Devuelto (la retención completa que vuelve tras un fallo o un timeout). Consulta Facturación para ver cómo funcionan los cobros.

Facturación → Consumo (/console/billing/usage)

Tareas y gasto por día, en un gráfico, para los últimos 7, 30 o 90 días, o para un intervalo personalizado de hasta 92 días (días UTC). Debajo, Por modelo: tareas, fallos, gasto y porcentaje de cada modelo, con Ver tareas para saltar a esas tareas en Registros. Exportar CSV descarga los totales diarios que se muestran. El endpoint de consumo de la API solo informa sobre la clave que lo llama; esta página muestra todo el ámbito seleccionado en la barra lateral.

Facturación → Facturas (/console/billing/invoices)

Introduce tus datos de facturación, emite una factura de pago por una recarga pagada o un detalle de consumo de un mes cerrado, y crea Extractos de la cuenta mensuales (CSV). En qué se diferencia cada documento y cómo corregir uno se explica en Configura tu cuenta → Facturas y recibos.

Claves de API

Crea, edita y revoca las claves que usan tus programas. La lista muestra de cada clave su valor enmascarado, lo gastado hasta ahora, los límites, los modelos permitidos, la lista de IP permitidas, la caducidad y cuándo se usó por última vez. Puedes buscar por nombre o por clave enmascarada y filtrar por Activa, Expirada o Revocada.

• Crear clave crea una clave en el ámbito seleccionado en la barra lateral. La clave completa se muestra una sola vez.
• Editar cambia el nombre, los límites de gasto (diario, mensual y acumulado), los modelos permitidos, la lista de IP permitidas y la caducidad. Al editar, un límite vacío significa que no hay límite.
• Revocar detiene una clave de inmediato y no se puede deshacer. Las tareas que ya se habían aceptado siguen ejecutándose y se cobran.

Cada campo se explica en Configura tu cuenta → Crea una clave de API. Los códigos de error que produce cada restricción están en Autenticación.

En un equipo: solo puedes crear y gestionar las claves del equipo con el rol Propietario, Administrador o Desarrollador. El consumo y los límites de una clave de equipo cuentan para el equipo, y sus tareas las paga el propietario del equipo.

Webhooks

Un webhook es un mensaje que SpicyAPI envía a tu propio servidor cuando una tarea termina, para que no tengas que estar preguntando. La dirección se elige en cada tarea con callBackUrl. Esta página hace dos cosas.

Clave de firma de webhooks. Cada callback va firmado, para que tu servidor pueda comprobar que de verdad viene de SpicyAPI. Tu cuenta tiene una sola clave de firma, compartida por todas sus claves de API, y su valor solo se muestra una vez, en el momento de crearla. Las cuentas nuevas ya tienen una clave que nadie ha visto, así que la tarjeta puede decir Configurada aunque no tengas nada que copiar:

1. Elige Generar (si la tarjeta dice Sin configurar) o Rotar (si dice Configurada).
2. Copia la clave nueva en los ajustes de tu servidor, normalmente como SPICY_WEBHOOK_SECRET.
3. Elige Ya la guardé.

Entregas de webhook. Cada intento de callback de tu cuenta, del más reciente al más antiguo, con filtros Entregado, Reintentando y Fallido, el número de intentos y la hora del próximo reintento. Reintentar vuelve a enviar el mensaje firmado original; asegúrate de que tu servidor puede recibir el mismo mensaje dos veces sin problemas. Una entrega cuyo contenido almacenado ya se haya borrado según tus ajustes de conservación no se puede reintentar.

Integraciones

Configuraciones listas para copiar y pegar de las herramientas que funcionan con SpicyAPI. Elige una herramienta para ver su configuración y Abrir docs.

• Fundamentos de la conexión: la URL base para clientes compatibles con OpenAI y un atajo Crear clave. Ponle a cada clave el nombre de la herramienta que la usa.
• Herramientas oficiales: el SDK de TypeScript, la CLI, el servidor MCP y el Agent Skill.
• Clientes compatibles con OpenAI: herramientas que te dejan cambiar la URL base, para modelos de texto y de video. La generación de imágenes no está disponible en los endpoints compatibles.
• Agentes de código: editores y agentes que añaden el servidor MCP, que te pide confirmar cada cobro.

Los fragmentos usan el marcador MODEL_ID_FROM_CATALOG: sustitúyelo por un ID de modelo exacto del catálogo en vivo (GET /api/v1/models, spicyapi models list o listModels()). Consulta Modelos.

Registros

Todas las tareas, de la más reciente a la más antigua, incluidas las fallidas. Cada fila muestra la tarea, el modelo, el estado, la latencia y el costo.

• Filtros: estado, modelo e intervalo de fechas. El cuadro de búsqueda acepta un ID exacto de tarea o de solicitud, que es la forma más rápida de encontrar la tarea que hay detrás de un informe de error. La página carga hasta 500 filas; para ver más, acota los filtros.
• Exportar CSV exporta todas las tareas que coinciden con los filtros: de forma predeterminada, los últimos 30 días, con un máximo de 92 días o 10.000 filas.
• Abrir los detalles de una tarea muestra su estado, su costo, la hora de inicio y de fin, la clave usada, el ID de tarea y el ID de solicitud, el código de error y el Motivo del fallo, los parámetros de la solicitud, la respuesta y los enlaces de descarga (Obtener enlace; cada enlace caduca y puedes generar otro).

El recuadro de costo muestra el importe retenido durante la ejecución y el cobro real una vez liquidado. Una tarea fallida puede tener un cargo por un rechazo de contenido expresamente indicado en la página del modelo. Consulta la liquidación en lugar de deducir un reembolso por el estado.

En los detalles de la tarea aparecen tres acciones:

Ninguna de estas acciones cancela una tarea en marcha: las tareas aceptadas no se pueden cancelar. Consulta Conservación y destrucción para ver qué se conserva y qué se borra.

En un equipo: todos los miembros ven las tareas del equipo con su estado y su costo. Solo Propietario, Administrador y Desarrollador ven los prompts, los resultados y los enlaces de descarga. Las tres acciones anteriores solo están disponibles para la cuenta que pagó la tarea.

Equipo

Crea equipos, invita a personas, cambia roles, fija los límites de gasto del equipo, y sal de un equipo o traspásalo. ¿Trabajas solo? No necesitas un equipo: tus claves, tu saldo y tu consumo ya funcionan por sí solos. Todo lo relativo a los equipos está más abajo, en Equipos.

Ajustes

Una sola página, organizada en grupos.

Cuenta

• Correo, marcado como Verificado o Sin verificar. Para cambiar el correo con el que inicias sesión, usa Cambiar el correo de acceso: enviamos un enlace de confirmación a la dirección nueva (válido durante 20 minutos) y un aviso a la antigua. Necesitas tu contraseña actual.
• Nombre visible, ID de cuenta (indícalo cuando contactes con soporte) y Miembro desde.

Seguridad

• Contraseña. Cambiarla cierra la sesión en todos los dispositivos. Una cuenta creada con Google o GitHub no tiene contraseña hasta que eliges Enviar el enlace por correo y defines una; necesitas una contraseña para cerrar la cuenta o traspasar un equipo.
• Dispositivos conectados. Usa Cerrar sesión en cualquier dispositivo que no reconozcas, o Cerrar todas las sesiones (incluida la de este dispositivo) si crees que otra persona tiene acceso. Justo después, cambia tu contraseña.
• Autenticación en dos pasos. Elige Configurar 2FA, introduce tu contraseña actual, añade la cuenta a una aplicación de autenticación y escribe el código de seis dígitos que muestra. A partir de entonces, cada inicio de sesión pide un código. También recibes diez códigos de recuperación de un solo uso: guárdalos en un lugar que no sea tu teléfono, porque sin el teléfono son la única forma de volver a entrar, y no se pueden volver a mostrar. Nuevos códigos de recuperación los sustituye todos; Desactivar 2FA quita la protección. Las dos acciones te piden antes que confirmes que eres tú.
• Actividad de seguridad: inicios de sesión recientes, dispositivos nuevos y cambios de credenciales.

Preferencias

• Idioma de los errores de la API: el idioma de msg en las respuestas de error y de errorMessage en las tareas (en las consultas de estado y en los webhooks) para las solicitudes hechas con tus claves de API. El valor predeterminado es el inglés. La cabecera Accept-Language de una solicitud tiene prioridad, y los códigos en los que debe basarse tu programa (code, errorCode) no cambian nunca. Consulta Errores.

Facturación y datos

• Accesos directos a Datos de facturación y extractos (en Facturación → Facturas) y a Datos y privacidad (la página Protección de datos).

Zona de riesgo: Cerrar cuenta

Cerrar la cuenta cierra la sesión en todos los dispositivos, revoca de forma permanente todas las claves de API y borra los medios generados y el contenido de las tareas que se conservaba. Los registros de facturación, de auditoría y de conciliación se mantienen, tal como describe la Política de privacidad. Las órdenes de recarga abandonadas que nunca pagaste se cancelan por ti. El cierre solo se queda en espera mientras:

• haya tareas en cola o en ejecución, o tareas terminadas que aún se están liquidando (normalmente en menos de un minuto);
• un pago de recarga siga en proceso (se resuelve solo cuando el proveedor de pago lo confirma o lo libera, normalmente en unos minutos; contacta con soporte si sigue ahí pasada una hora);
• la cuenta deba dinero (crédito aprobado en uso o saldo negativo), algo que resuelves recargando;
• un equipo del que eres propietario todavía tenga que traspasarse a otro miembro o quedarse sin más miembros.

La consola enumera todo lo que todavía lo impide. Lo confirmas con tu contraseña actual o, si te registraste con Google u otro proveedor de inicio de sesión y no tienes contraseña, con un código de 6 dígitos que te enviamos por correo (válido durante 15 minutos).

Notificaciones

• Aviso de saldo bajo. Actívalo y elige un umbral ($5, $10, $25, $50 o $100). Cuando tu saldo disponible baja de ese umbral, recibes un aviso en la campana de notificaciones y, si tu cuenta tiene dirección de correo, también un correo. Solo vuelves a recibir el aviso cuando el saldo ha subido de nuevo hasta el umbral o por encima y después vuelve a bajar. Los saldos se comprueban aproximadamente cada 10 minutos.
• Novedades de los modelos que sigues. Sigue un modelo desde su página en spicyapi.ai; Gestionar abre la lista de modelos seguidos y las novedades del producto.
• Entrega. Los avisos dentro de la aplicación están siempre activados. Los correos de Novedades del producto y de Ofertas y anuncios se pueden activar o desactivar. Los avisos de seguridad, de facturación y críticos para el servicio se envían siempre.

Protección de datos

• Conservación: tres plazos independientes para Resultados generados, Texto de los prompts y Archivos subidos. Solo puedes hacerlos más cortos que los máximos de la plataforma (14 días para los resultados, 30 días para el texto de los prompts y 24 horas para las subidas). Acortar un plazo puede borrar contenido de tareas que ya ejecutaste en la siguiente limpieza, que se hace en menos de un minuto; antes de que confirmes, la consola cuenta lo que se verá afectado, y el contenido borrado no se puede recuperar. Descarga antes todo lo que quieras conservar.
• Retención del contenido de tareas: una tarjeta más antigua con dos ajustes. Conservar contenido de tareas muestra, en días, cuánto tiempo se guarda el contenido de las tareas; ese tiempo se ajusta con los tres plazos anteriores. Borrar poco después de terminar borra el contenido de una tarea terminada aproximadamente una hora después de que se hayan almacenado sus resultados y se haya entregado su webhook.
• Adónde van tus datos: un resumen de los compromisos que ya recoge la Política de privacidad, entre ellos que tus entradas y resultados no se usan para entrenar modelos.
• Descargar mis datos: un archivo JSON con tu perfil, tus roles en equipos, los datos de tus claves de API (nunca las claves en sí), los datos de tareas conservados y los registros de facturación. No incluye archivos multimedia, así que descarga los resultados por separado.

Las reglas completas, incluido el ajuste por solicitud y qué se conserva al borrar, están en Conservación y destrucción.

Soporte

Abre una conversación privada que solo pueden leer tú y el equipo de soporte de SpicyAPI. Elige Nueva conversación, un asunto y un tema (Cuenta, Facturación, Integración de API, Tarea o resultado, Privacidad, Empresas u Otro tema), y describe lo que ha pasado. Las respuestas aparecen en la conversación (con el estado En espera de soporte, Esperando tu respuesta, Resuelta o Cerrada) y en la campana de notificaciones.

Ayúdanos a ayudarte rápido: incluye el ID de la tarea, el request_id de una respuesta de error o el ID de la orden de recarga, y aproximadamente cuándo ocurrió (en UTC). No pegues nunca una clave de API, una contraseña ni datos de tarjeta. También puedes escribir a support@spicyapi.ai.

Equipos

Ámbito personal y equipos

Todas las cuentas tienen un ámbito Personal. Nadie más está en él y, si trabajas solo, es todo lo que necesitas: tus claves personales, tu saldo y tu consumo funcionan sin equipo.

Un equipo permite que varios compañeros compartan claves de API, vean el mismo historial de tareas y trabajen con límites de gasto comunes. Cada equipo tiene sus propios miembros, sus propias claves y sus propios límites.

El selector de ámbito, arriba del todo en la barra lateral, decide qué muestra la consola:

• Personal: solo tu propio ámbito.
• El nombre de un equipo: solo las claves, las tareas, el consumo y la actividad de ese equipo.
• Todos los ámbitos: todo aquello a lo que tienes acceso, combinado.
• Nuevo equipo: un atajo para crear uno.

También decide a dónde va una clave de API nueva: una clave creada mientras hay un equipo seleccionado pertenece a ese equipo.

Quién paga en un equipo

Todas las tareas enviadas con una clave de API de un equipo se pagan con el saldo del propietario del equipo. Es la regla más importante de los equipos.

• Los miembros nunca recargan saldo en un equipo y nunca ven el saldo, las recargas, los datos de pago ni las facturas del propietario.
• Si eres miembro y una clave del equipo empieza a devolver 40201, quien tiene que añadir saldo es el propietario.
• Tus claves personales, tu saldo y tu consumo nunca se comparten con un equipo al que te unas, y salir de un equipo no los toca.
• Un propietario, un administrador o un desarrollador puede crear claves de equipo que gastan el saldo del propietario. Si eres propietario, fija límites de gasto del equipo y pon a cada clave sus propios límites.

Crear un equipo

1. Abre Equipo y elige Crear un equipo (o Nuevo equipo en el selector de ámbito).
2. Escribe un nombre para el equipo (hasta 120 caracteres) y elige Crear equipo.

Pasas a ser el Propietario del equipo. Una cuenta puede ser propietaria de hasta 10 espacios de trabajo, y tu ámbito Personal cuenta como uno de ellos, así que puedes crear hasta nueve equipos. No hay límite de equipos de otras personas a los que puedas unirte.

Invitar a personas

Solo un Propietario o un Administrador puede invitar.

Reglas de las invitaciones:

• Una invitación solo la puede aceptar una cuenta cuyo correo coincida con la dirección invitada. Con otro correo se recibe Please sign in with the invited email address to accept this invite.
• Las cuentas de autocustodia privada no pueden unirse a equipos, porque no tienen dirección de correo.
• Una sola invitación pendiente por correo y por equipo. A alguien que ya es miembro no se le puede volver a invitar.
• Un equipo puede tener hasta 100 miembros, incluido el propietario.
• Revocar cancela una invitación pendiente en cualquier momento; más adelante puedes volver a invitar a la misma persona.
• Una invitación caducada no se puede aceptar. Envía una nueva.

Roles y permisos

La consola muestra los roles con estos nombres. La API y las exportaciones usan los nombres en minúsculas que aparecen entre paréntesis.

Además:

• Nadie puede cambiar su propio rol. El rol del propietario solo cambia mediante un traspaso.
• Reintentar, destruir o quitar una tarea solo lo puede hacer la cuenta que la pagó, sea cual sea el rol.
• Un miembro con un rol que no puede leer contenido ve Tu rol permite ver el estado de las tareas y el consumo, pero no leer prompts ni resultados.
• Nadie salvo el propietario ve nunca el saldo personal, las recargas, los datos de pago ni las facturas del propietario. Actividad del equipo solo enumera los movimientos de dinero causados por las tareas del equipo.

Límites de gasto del equipo

Cada equipo (y tu ámbito Personal) tiene un límite diario y otro mensual en dólares estadounidenses, en Equipo → tu equipo → Límites de gasto. Los propietarios, los administradores y los gestores de presupuesto pueden cambiarlos con Editar y después Guardar límites.

• Cubren, en conjunto, todas las tareas enviadas con las claves de ese ámbito.
• Cuentan tanto el dinero ya cobrado como el dinero retenido para tareas que siguen en marcha.
• El límite diario se reinicia a las 00:00 UTC; el mensual, el día 1 de cada mes a las 00:00 UTC.
• Sin límite es el valor predeterminado. Escribe 0 para no poner límite. Si dejas un campo vacío, se mantiene su valor actual.
• Una tarea que superaría un límite se rechaza con 40202 y el mensaje Workspace daily budget has been reached o Workspace monthly budget has been reached. No se crea nada y no se retiene nada.

Los límites del equipo se aplican además de los límites diario, mensual y acumulado de cada clave y del saldo del propietario. Lo primero que se agote detiene la tarea. Consulta Facturación para ver todos los límites de gasto.

Cambiar roles y quitar miembros

Abre el equipo. En Miembros, elige un rol nuevo para un miembro y confirma con Cambiar rol; el cambio es inmediato. Quitar saca a un miembro del equipo al momento: pierde el acceso al equipo, a sus claves y a su actividad. Al propietario no se le puede quitar.

Quitar a un miembro no revoca las claves que creó o usó. Las claves del equipo pertenecen al equipo, así que revoca en Claves de API cualquier clave que esa persona todavía tenga.

Salir de un equipo

Cualquier miembro salvo el propietario puede salir: abre el equipo, elige Salir del equipo y confírmalo. El acceso termina de inmediato, y solo una invitación nueva te permite volver.

No se borra nada. Las claves, las tareas y el consumo del equipo se quedan en el equipo y se siguen cobrando a su propietario. Si todavía tienes una de sus claves, pide a un administrador que la revoque. Tu ámbito personal no se toca.

El propietario no puede salir sin más, porque las claves del equipo seguirían gastando su dinero sin que nadie pudiera gestionarlas. Traspasa antes la propiedad. Si eres el único miembro, invita a alguien y pásale el equipo.

Traspasar la propiedad

Solo el propietario puede traspasar el equipo, y solo a alguien que ya sea miembro.

1. Abre el equipo y ve a Zona de riesgo → Transferir propiedad.
2. Elige al Nuevo propietario y escribe tu Contraseña actual. (Una cuenta creada con Google o GitHub tiene que definir antes una contraseña en Ajustes).
3. Revísalo y elige Transferir equipo.

A partir de ese momento:

• el saldo del nuevo propietario paga todas las tareas enviadas con las claves del equipo, y todas las claves del equipo pasan a la cuenta del nuevo propietario;
• tú pasas a ser Administrador;
• las tareas aceptadas antes del traspaso conservan su facturación original y no se cancelan.

Eliminar un equipo

Un equipo no se puede eliminar. Un equipo sin uso no cuesta nada y nunca aparece en una factura. Quita a sus miembros y déjalo inactivo, o cámbiale el nombre y reutilízalo en lugar de crear otro.

Límites de los equipos de un vistazo