Reserva y cargo

• Precio : se indica en dólares por 1 millón de tokens de entrada y salida (o por unidad: imagen, segundo de vídeo o caracteres). Los precios de cada modelo están en el catálogo.
• Reserva : antes de enviar una nueva solicitud de texto, Ailoot reserva una estimación de la entrada y de una respuesta típica según las condiciones aceptadas para la solicitud. Para imágenes, vídeo y audio de salida se mantiene la reserva del coste completo del resultado.
• Reducir el límite en lugar de rechazar : si la reserva calculada no cabe en el saldo disponible o en el límite de la clave, el límite de respuesta solo puede reducirse para un modelo y un método concretos que lo respeten, y únicamente hasta un volumen que pueda pagarse, sin bajar del mínimo aplicable. Consulta qué modelos lo admiten ver detalles.
• Cargo : uno solo, según el consumo real indicado en usage. El resto de la reserva se devuelve inmediatamente.
• Si la respuesta cuesta más que la reserva , la diferencia se toma del saldo disponible que no esté reservado para otras solicitudes. El cargo nunca supera tu saldo: el saldo no queda en negativo.
• Si el saldo no alcanza ni para la reserva mínima , la solicitud no se envía al modelo y recibes un error 402 con un mensaje claro. No se cobra nada.
• No se cobra un fallo sin resultado. Si se pierde la conexión, consulta la solicitud por su Request ID en el historial del panel de control antes de volver a enviarla.

• Entrada : se reserva a partir de una estimación del tamaño de la solicitud y de los adjuntos admitidos, no de un consumo real ya conocido. En las nuevas solicitudes de texto se estiman el cuerpo y los adjuntos según su tipo. El cálculo «4 tokens por byte, con un mínimo de 4096 tokens» corresponde a reservas de la versión anterior que ya fueron aceptadas y no describe las nuevas reservas de texto. Si el adjunto se envía mediante un enlace (fileData) o se activan herramientas integradas, en las solicitudes de texto admitidas se tienen en cuenta estimaciones separadas de los adjuntos y del trabajo de las herramientas; su mera presencia no implica reservar toda la ventana de entrada. Las reservas anteriores conservan las condiciones aceptadas, mientras que para los medios de salida se calcula el resultado completo.
• Salida : para la reserva de una nueva solicitud de texto, se estima según la longitud típica de la respuesta y las condiciones aceptadas. El límite solicitado se especifica mediante max_tokens (max_output_tokens en Responses). El límite solicitado no coincide automáticamente con el número de tokens usado para calcular la reserva ni garantiza la longitud real de la respuesta en un modelo sin una limitación fiable. El valor inicial de 4096 solo se aplica a las rutas correspondientes; la regla concreta depende del modelo y del método.
• Precio : para las nuevas reservas de texto, según las condiciones de la solicitud, se tienen en cuenta el modo estándar o prioritario y los tramos de precio alcanzables según la estimación de entrada. Dentro de las condiciones elegidas, el cálculo sigue siendo conservador; el modo flex no reduce la reserva. En una solicitud prioritaria, la reserva puede tener en cuenta el modo aplicable más caro, incluidos priority, flex o fast. Las reservas aceptadas anteriormente sin estas condiciones conservan el cálculo original con las tarifas máximas.
• Reducción del límite : cuando la reserva calculada no cabe y el modelo y el método concretos permiten limitar la respuesta, los fondos disponibles deben cubrir la estimación de entrada y el volumen mínimo de salida. El límite reducido nunca baja de 256 tokens (1025 con pensamiento en formato Anthropic). El modelo recibe el límite ya reducido.

Modelo claude-sonnet-5-5: entrada a $2 y salida a $10 por 1 millón de tokens. Has enviado 20 000 tokens y el modelo ha respondido con 1 200 tokens.

En el ejemplo aritmético mostrado, el coste real es de $0.0520. El cargo indicado presupone que la reserva aceptada y el saldo libre disponible cubren ese coste. Aquí no se calcula el importe de la reserva: para una nueva solicitud de texto se determina por separado a partir de una estimación de la entrada y de una respuesta típica, y puede ser mayor o menor que el coste real. La reserva no utilizada se libera; la fórmula siguiente establece el límite del cargo.

Cargo real = min(coste real total, reserva aceptada + saldo libre no reservado). Las demás reservas abiertas siguen protegidas, por lo que el saldo total no tiene por qué quedar a cero. El saldo no queda en negativo. Si el coste real supera la reserva aceptada más el saldo libre no reservado, la diferencia no cubierta queda como pérdida de Ailoot: no se convierte en una deuda tuya ni se cobra posteriormente.

Cerrar la conexión, alcanzar el tiempo de espera de tu aplicación o dejar de leer una respuesta ya terminada no cancela automáticamente la solicitud: la respuesta terminada del modelo se cobra una sola vez. Si el resultado no se entrega por un fallo de Ailoot, se devuelve el dinero. Si se pierde la conexión, consulta la solicitud por su Request ID en el historial del panel de control antes de volver a enviarla.

• Para las nuevas solicitudes de texto, la reserva de la respuesta se calcula según su longitud típica, teniendo en cuenta el max_tokens indicado y las condiciones del modelo concreto. Es una estimación de la reserva, no una garantía de la longitud ni del coste real de la respuesta.
• En los modelos sin un límite fiable para la respuesta real, la estimación de la reserva no se convierte en una limitación de longitud. Para las nuevas solicitudes de texto, no se sustituye automáticamente por el coste de la respuesta más larga. Las reservas aceptadas anteriormente conservan sus condiciones originales.
• Las imágenes de entrada añaden a la reserva una estimación de su coste.
• Los agentes (Claude Code, Codex CLI y Cline) envían un contexto grande en cada paso: un solo paso puede reservar decenas de céntimos. Mantén al menos unos dólares de saldo.
• Consejo: establece un max_tokens razonable para reducir la reserva en los modelos que permiten limitar la longitud de respuesta.

Los modelos con caché tienen precios distintos para la escritura y la lectura. La lectura suele ser varias veces más barata que la entrada normal. Los precios aparecen en la ficha del modelo en el catálogo.

Si el saldo disponible no alcanza ni para la reserva mínima, Ailoot no envía la solicitud y responde con 402 y el código insufficient_balance. Si se ha agotado el límite total de gasto de la clave, el código es api_key_quota_exhausted. Si la cuenta tiene una deuda por un pago impugnado, el código es payment_disputed: las nuevas solicitudes quedan suspendidas hasta que se pague la deuda.

{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

El historial de solicitudes y cargos está en el panel de control de ailoot.ai. Para cada solicitud se muestran el modelo, los tokens y el importe.