Las ejecuciones del servicio alojado se pagan con créditos prepagados. Cada ejecución tiene un presupuesto. Ephemeral reserva todo el presupuesto antes de que empiece la ejecución, cobra lo que esta usó y libera el resto.
Unidades
Todos los importes son números enteros en dólares estadounidenses, en una de dos unidades.
| Unidad | Se usa para | Un dólar |
|---|---|---|
*_ | Presupuestos de ejecuciones, costes de ejecuciones, saldos del monedero y entradas del libro de movimientos | 1000000 |
*_ | Compras con Stripe, recargas automáticas e historial de pagos | 100 |
Así, cost_micros: 10000 es un centavo, y amount_cents: 2500 son $25. Un campo de dinero que falta en un objeto de ejecución vale cero.
Cuánto cuesta una ejecución
El coste de una ejecución tiene hasta tres partes.
- Cómputo. El tiempo desde que la ejecución sale de la cola hasta que termina, redondeado hacia arriba a segundos completos, a la tarifa de cómputo. Nunca supera el cargo del tiempo límite completo.
GET /v1/medevuelve la tarifa comocompute_micros_per_second. - Llamadas al modelo. Antes de cada llamada al modelo, Ephemeral consulta el precio actual del modelo y autoriza un límite superior prudente para la llamada. Cuando el proveedor informa de lo que costó realmente la llamada, esa cantidad sustituye a la autorización. Si una respuesta se pierde, se interrumpe o llega sin un coste fiable, se mantiene cobrado el límite superior.
- Solicitudes web. Cuando la ejecución tiene acceso web, cada solicitud cuesta $0.001 y cada búsqueda $0.01, que se cobran al enviarse. Las solicitudes rechazadas no se cobran.
Las ejecuciones alojadas admiten texto y modelos cuyo precio se puede acotar de antemano. GET /v1/models lista los modelos que cumplen los requisitos, con sus precios.
Presupuestos
Define el presupuesto con max_cost_micros en la solicitud de ejecución. Puede ir de 1 a 100000000 ($100). Si lo omites, se aplica el presupuesto predeterminado; GET /v1/me lo devuelve como default_max_cost_micros.
El presupuesto debe cubrir el cargo de cómputo del tiempo límite completo: al menos timeout_seconds multiplicado por compute_micros_per_second. Un presupuesto menor se rechaza con 400; acorta el tiempo límite o aumenta el presupuesto.
A 200 microdólares por segundo ($0.72 la hora), el tiempo límite predeterminado de 300 segundos necesita al menos 60000 y el máximo de 3600 segundos necesita 720000. El presupuesto predeterminado de 500000 cubre tiempos límite de hasta 2500 segundos.
Durante la ejecución, se rechaza cualquier llamada al modelo cuyo límite superior llevaría a la ejecución más allá de su presupuesto, y también cualquier solicitud web que lo hiciera. Así la ejecución se mantiene dentro de su presupuesto. La llamada rechazada devuelve un error al agente, y la ejecución normalmente termina como failed.
Reservar, cobrar, liberar
- Cuando creas una ejecución, su estado es
reservingmientras se reserva todo el presupuesto de tus créditos disponibles. Si hay muy pocos disponibles, la solicitud falla con402y la ejecución se registra comofailed. - Mientras la ejecución está activa,
cost_microsincluye el cargo de cómputo del tiempo límite completo más cada llamada al modelo, a su coste informado una vez que el proveedor lo envía o a su límite superior hasta entonces, más cada solicitud web. - Cuando la ejecución termina, el cargo de cómputo se recalcula con el tiempo realmente usado.
- Ephemeral carga el coste final a tu saldo y libera el resto de la reserva. Entonces
billing_pendingpasa afalse.
cost_micros como definitivo solo cuando el estado de la ejecución es final y billing_pending es false. Antes de eso, puede ser mayor que el importe que se te cobra.Créditos y pagos
Los propietarios y administradores compran créditos en el portal de clientes, en Facturación, mediante Stripe Checkout. Cada compra es de $5 a $10,000. Los créditos se añaden cuando Stripe confirma el pago, normalmente en cuestión de segundos. Volver de la página de Checkout no añade créditos por sí solo.
| Campo del monedero | Significado |
|---|---|
balance_ | Créditos que tienes. |
reserved_ | Créditos reservados para ejecuciones que aún no se han liquidado. |
available_ | Saldo menos reservas. Las nuevas ejecuciones reservan de aquí. |
El monedero también muestra las últimas 100 entradas del libro de movimientos, enlazadas con la ejecución o el pago que hay detrás de cada una. El libro de movimientos es un historial de la cuenta y no es una factura; Stripe proporciona un recibo por cada pago.
La recarga automática cobra una tarjeta guardada cuando el cargo de una ejecución deja tu saldo por debajo de un umbral que eliges. Requiere una tarjeta guardada y tu consentimiento explícito. El importe de la recarga es de $5 a $10,000, y el umbral es de al menos $1 y no más que el importe de la recarga. Guardar una tarjeta no la activa. Quitar la tarjeta seleccionada sin elegir otra como predeterminada la desactiva.
Los reembolsos y las disputas se descuentan del saldo y desactivan la recarga automática. Si un reembolso deja el saldo en negativo, las nuevas ejecuciones se bloquean hasta que recargues créditos.
Los créditos no caducan nunca. En los 14 días siguientes a una compra, puedes pedir a soporte que se reembolsen a tu tarjeta los créditos de esa compra que no hayas usado. Los créditos ya usados o reservados por una ejecución en curso no se reembolsan. Consulta los Términos del servicio.