Cuentas de empresa

Una cuenta de empresa permite que todo un equipo gaste de un único saldo. El saldo de la cuenta del propietario pasa a ser el saldo de la empresa, cada miembro llama a la API con su propia clave y cada cargo sale de ese saldo compartido. Los endpoints, los cuerpos de las solicitudes y la configuración del cliente son los mismos que en una cuenta personal; esta página solo cubre lo que cambia cuando quien llama pertenece a una empresa.

Un miembro envía una solicitud

acme-…

Con su propia clave, que empieza por el prefijo de la empresa.

Comprobación del presupuesto

El coste estimado tiene que caber en lo que queda del presupuesto del miembro.

Se cobra a la empresa

Con los precios, grupos y suscripción de la cuenta del propietario.

Se registra a nombre del miembro

El propietario y los administradores pueden desglosarlo por miembro, modelo, clave y fecha.

Los miembros nunca tienen dinero propio. Un presupuesto solo limita cuánto pueden gastar del saldo de la empresa.

Roles

Rol	Cuenta	Qué puede hacer
Propietario	La cuenta que presentó la solicitud	Su saldo es el saldo de la empresa. Gestiona a todos, recarga saldo y ve el uso de toda la empresa. No se puede desactivar.
Administrador	Creada a partir de una invitación	Llama a la API dentro de un presupuesto, invita y gestiona miembros, recarga saldo y ve el uso de toda la empresa.
Miembro	Creada a partir de una invitación	Usa la API, el espacio de trabajo de imagen y vídeo y Castaly dentro de un presupuesto. No puede recargar saldo.

Los administradores y los miembros son cuentas nuevas creadas a partir de una invitación por correo electrónico. La dirección invitada no puede estar ya registrada, así que una cuenta personal existente no puede unirse a una empresa. Estas cuentas no participan en las recompensas de la plataforma.

El propietario y los administradores pueden desactivar una cuenta en cualquier momento, y sus sesiones y claves dejan de funcionar de inmediato. Las cuentas se desactivan, nunca se eliminan, así que su historial de uso se conserva.

Claves API

Las claves de empresa empiezan por el prefijo de clave de la empresa, por ejemplo acme- seguido de 48 letras y dígitos. El prefijo se elige al presentar la solicitud; queda fijado al aprobarla y no se puede cambiar después. Un prefijo tiene de 2 a 16 letras minúsculas y dígitos y empieza por una letra.

La misma clave también funciona con sk- en lugar del prefijo. Use esa forma con cualquier cliente que solo acepte claves que empiecen por sk-: ambas formas son la misma clave, con los mismos permisos y la misma facturación.

Authorization: Bearer acme-<48 characters>
Authorization: Bearer sk-<48 characters>

Una clave presentada con un prefijo que no es el de su propia empresa se rechaza como clave no válida con 401.

Las claves que el propietario creó antes de que se aprobara la solicitud también se muestran con el prefijo de la empresa. Su forma con sk- sigue funcionando, así que las integraciones existentes no necesitan cambios.

Los administradores y los miembros solo crean y ven sus propias claves en la consola. El propietario y los administradores pueden gestionar todas las claves de la empresa desde la consola de empresa, filtradas por miembro.

Presupuestos de los miembros

Cada administrador y cada miembro tiene un presupuesto. No se les transfiere dinero; el presupuesto es lo máximo que pueden gastar del saldo de la empresa.

Modo	Comportamiento
Ilimitado	Limitado solo por el saldo de la empresa.
Único	Una asignación fija que nunca se restablece por sí sola.
Mensual	Vuelve a empezar desde cero a las 00:00 UTC del día 1 de cada mes.

Cambiar solo el límite conserva el importe ya usado. Cambiar a otro modo vuelve a contar desde cero.

Antes de ejecutar una solicitud, el gateway reserva su coste estimado contra el presupuesto restante del miembro y la rechaza si no cabe. Después, la solicitud se liquida por su coste real. La liquidación nunca rechaza, así que la última solicitud puede dejar a un miembro ligeramente por encima del límite; la siguiente se rechaza. Cuando una solicitud falla o se reembolsa, el importe también vuelve al presupuesto del miembro.

Los miembros reciben un correo cuando han usado el 80 % de su presupuesto y otro cuando se agota.

Facturación, grupos y límites de solicitudes

Para el gateway, la solicitud de un miembro es una solicitud de la cuenta del propietario. Todo salvo el presupuesto sigue al propietario:

Los cargos salen del saldo de la empresa igual que si llamara el propietario, incluida la suscripción del propietario.
Los precios, los grupos y los modelos que puede llamar una clave son los de la cuenta del propietario.
Los límites de solicitudes cuentan para toda la empresa. El propietario y todos los miembros comparten una misma cuota, así que un 429 puede deberse al tráfico de otra persona.

Cuando se agota el saldo de la empresa, las solicitudes de todas las personas de la empresa fallan con 403 y insufficient_user_quota, igual que en una cuenta personal. El propietario y los administradores pueden recargar desde la consola de empresa; los miembros no. Con una alerta de saldo configurada, el propietario y los administradores reciben un correo cuando el saldo baja de ese umbral.

Errores

Situación	Estado	Cómo reconocerlo
La clave lleva el prefijo de otra empresa	`401`	Rechazada como clave no válida
El presupuesto del miembro se ha agotado	`403`	`code` es `enterprise_member_budget_exhausted`
El miembro fue desactivado o la empresa fue suspendida	`403`	`message` indica que la cuenta está desactivada
El saldo de la empresa se ha agotado	`403`	`code` es `insufficient_user_quota`
La empresa en conjunto alcanzó un límite de solicitudes	`429`	Igual que en una cuenta personal

Reintentar no resuelve los casos 401 y 403. Un error de presupuesto desaparece cuando un administrador sube el límite o, con un presupuesto mensual, cuando empieza el mes siguiente; un error de saldo desaparece tras una recarga.

Tareas asíncronas

Una tarea enviada con la clave de un miembro solo se puede consultar con las claves de ese miembro. Consultarla con la clave de otro miembro devuelve el mismo resultado que una tarea que no existe. Las claves del propietario pueden consultar las tareas enviadas por cualquier persona de la empresa.

Uso y registros

Cada registro de solicitud indica qué miembro envió la solicitud.
En su propia consola, los administradores y los miembros solo ven sus propias solicitudes.
La página de registros del propietario muestra las solicitudes de toda la empresa, con una columna adicional de Miembro.
El propietario y los administradores pueden desglosar el gasto por miembro, modelo, clave y fecha en la consola de empresa, y abrir las solicitudes individuales de cualquier miembro.
Hasta dónde llega depende de la retención de registros de la cuenta del propietario; consulte Retención de datos. Si el propietario la acorta, los informes de la empresa se acortan con ella.

Obtener una cuenta de empresa

Presente la solicitud desde la consola de Modelflare con el nombre de la empresa, el prefijo de clave que desea y un correo de contacto. Cuando se aprueba la solicitud, su cuenta pasa a ser la del propietario, su saldo se convierte en el saldo de la empresa e invita a su equipo desde la consola de empresa. La página Empresas describe el plan completo.