Sección 12
Precios
Lo que consume cada operación de la API, en créditos. El turno del agente se factura con un solo código y un solo precio; el resto, cada uno por su propia unidad. Aquí están los dos.
Qué es un turno
Un mensaje que usted envía a la API, atendido por el agente, con su respuesta. Una conversación son tantos turnos como mensajes atienda; lo que sigue es el precio de uno.
El precio del turno
| Código de facturación | Créditos | Unidad |
|---|---|---|
agent_turn | 11 | petición |
11 créditos por turno, siempre. No es un techo ni un rango: no hay ningún cobro condicional, así que puede calcular su consumo multiplicando por el número de turnos que espera atender. El precio incluye la generación de la respuesta y la clasificación de la intención del mensaje, que ocurren juntas y no se facturan por separado.
Un turno que no produce respuesta no cobra nada. Si la generación falla —nuestro servicio, no su servidor— el crédito reservado se le devuelve.
Se cobra una vez por turno. El cobro lleva el identificador del trabajo (job_id), así que un
reintento suyo con la misma clave de idempotencia, o un reintento interno nuestro, no cobra dos veces
(página 05).
Es el precio de un turno de TEXTO. Si el mensaje trae un adjunto —audio, imagen, documento o vídeo—, además se cobra el análisis de ese adjunto, y no por turno sino por su propia unidad (segundos de audio, la imagen, el documento). Por eso no entra en la cifra de arriba: un precio que incluyera un audio no tendría cota. El consumo de cada adjunto aparece en su propia línea del desglose del periodo, con su código y su cantidad.
Por qué el turno de la API tiene su propio código
Porque es su tráfico y solo el suyo. Si compartiera código con el agente que atiende los canales de
la plataforma, una empresa que use las dos cosas vería una sola línea en su desglose mezclando lo
que consumió por WhatsApp con lo que consumió por la API, sin forma de separarlas. Con un código
propio, agent_turn es exactamente lo que le costó integrar.
Todas las cifras de esta página son las del sistema, no estimaciones de la documentación. Salen del
catálogo de precios que aplica el cobro, que es su única fuente. Y el importe que se le aplicó en cada
petición viaja en su respuesta (usage), así que no hace falta creerle a esta tabla: se concilia contra el
dato de la propia llamada.
Las demás operaciones, cada una por su unidad
Estas no se cobran por petición sino por lo que consumen, y el importe aplicado viaja en el usage de cada
respuesta con su código y su cantidad, así que se puede conciliar sin esperar la factura.
| Código de facturación | Créditos | Unidad | Mínimo facturado |
|---|---|---|---|
image_analysis | 55 | imagen | 1 imagen |
document_analysis | 40 | documento | 1 documento |
video_analysis | 270 | video | 1 video |
audio_transcription | 1 | segundo de audio | 10 segundos |
tts_synthesis | 1 | carácter normalizado | 1 carácter |
sentiment_analysis | 1 | petición | 1 petición |
voice_call_minute | 620 | minuto de llamada con IA | 1 minuto |
voice_transfer_minute | 230 | minuto de una pata de telefonía puenteada | 1 minuto |
video_analysis es la única de tarifa plana: se cobra por video, no por su duración, así que uno de diez
segundos y uno de cinco minutos cuestan los mismos 270 créditos. Es también por lo que su entrada tiene techo
de tamaño y de duración, y por lo que un video que los pasa se rechaza en vez de analizarse a medias
(página 15).
Los mínimos no son un margen nuestro: la transcripción tiene un mínimo facturable de 10 segundos porque es
lo que factura el proveedor, y los minutos redondean hacia arriba porque es lo que factura la telefonía. Una
nota de tres segundos se cobra por diez, y la cantidad que se aplicó siempre está en usage.quantity: si suma
las duraciones de sus audios sin ese suelo, su total no cuadrará con el desglose del periodo.
tts_synthesis cobra el texto normalizado, no el que usted escribió: «Dr.» se dice «Doctor» y «999» se
dice «novecientos noventa y nueve». Las cabeceras X-Asixto-Chars-* de la respuesta traen las tres cifras
—enviados, normalizados y cobrados— para que el número cuadre (página 15).
El análisis de sentimiento es una operación aparte y el turno no lo hace por su cuenta: si lo quiere, lo pide y lo paga.
Una llamada transferida a una persona cobra dos tramos
Cuando el agente puentea la llamada con alguien de su equipo, el tiempo se reparte en dos y cada tramo se cobra con su propio código, cada uno redondeando su minuto:
| Tramo | Código | Lo que se factura |
|---|---|---|
| Con el agente | voice_call_minute | 620 créditos por minuto |
| Puenteado con la persona | voice_transfer_minute | dos patas por minuto, o 460 créditos por minuto |
El tramo puenteado cuesta menos por pata porque ahí no corre nada de IA —ni voz a texto, ni modelo, ni síntesis—: es telefonía de operador. Y son dos patas porque durante el puente hay dos llamadas vivas, la original y la que abre hacia la persona, y el proveedor factura las dos.
Un intento de transferencia sobre una llamada que nadie descolgó no cobra nada, y se le informa igualmente de que el traspaso se pidió.
El entorno de pruebas cuesta lo mismo
🔴 ak_test_ consume créditos a estos mismos precios. El entorno de pruebas ejecuta contra los mismos
proveedores que producción, así que no hay tarifa reducida ni exención: lo que cambia entre los dos entornos es
la concurrencia, a quién se puede llamar y el aislamiento de los datos, no el precio
(página 14). Todo consumo se cobra en cualquier entorno y salga la llamada por el
número que salga. Presupueste sus pruebas con esta tabla.
Verificar un número de prueba no le cuesta créditos. El código que le enviamos para verificarlo lo paga Asixto; por eso sus envíos tienen límites (página 14). Las llamadas que haga después a ese número sí se cobran, a los precios de arriba.
Los créditos de bienvenida
Su cuenta recibe 3.000 créditos de bienvenida, una sola vez: no es una bolsa mensual y no se repone. Se acreditan solos cuando la cuenta cumple las dos condiciones:
- tiene el módulo del Gateway, y
- tiene un medio de pago verificado: el medio por defecto con el que se le cobran las facturas.
Llegan en cuanto se cumple la última de las dos, normalmente al verificar su tarjeta. Si en ese momento algo falla, un proceso que repasa las cuentas cada 15 minutos los acredita en su siguiente vuelta. Una cuenta con el acceso cortado por impago no los recibe hasta que se reactiva.
Son créditos como los que usted compra: se consumen a los mismos precios, en los dos entornos, y no caducan con el cambio de mes. Darse de baja del módulo y volver no concede una segunda bienvenida.
Lo que NO entra en el precio del turno
- Las llamadas a su servidor de herramientas no se le cobran a usted: el turno cuesta lo mismo si el agente consulta su catálogo tres veces o ninguna. Lo que sí está acotado son las rondas por turno (página 07).
- Leer el stream de una respuesta no cuesta nada, ni la primera vez ni al reanudarlo: el cobro sigue a la generación, no a la entrega. Si su cliente se desconecta a mitad, el turno cuesta lo mismo.
- El precio del crédito en dinero y las bolsas de cada plan: eso está en la página pública de precios, no aquí. Esta página cuenta cuántos créditos consume cada operación, no cuánto vale un crédito.
Cómo verificarlo en su cuenta
Cada respuesta de la API declara el consumo de la operación que la atendió (usage), y el desglose
por código de cada periodo está en su consumo de la cuenta. Si su suma no cuadra con esta tabla, es un
fallo nuestro: repórtelo con el identificador de la petición (página 10).