12Precios

Sección 12

Precios

.md

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ónCréditosUnidad
agent_turn11petició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ónCréditosUnidadMínimo facturado
image_analysis55imagen1 imagen
document_analysis40documento1 documento
video_analysis270video1 video
audio_transcription1segundo de audio10 segundos
tts_synthesis1carácter normalizado1 carácter
sentiment_analysis1petición1 petición
voice_call_minute620minuto de llamada con IA1 minuto
voice_transfer_minute230minuto de una pata de telefonía puenteada1 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:

TramoCódigoLo que se factura
Con el agentevoice_call_minute620 créditos por minuto
Puenteado con la personavoice_transfer_minutedos 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).