Cómo funcionan los créditos de Optio — el modelo de coste de la API de Jev

La fórmula

Cada solicitud cuesta ceil(tokens de entrada / 1.000) créditos, con un mínimo de 1 crédito por llamada. Los tokens de salida son siempre gratis — una decisión son unas pocas decenas de tokens, y no se te factura por ellos. Si una solicitud falla (error upstream, timeout, sobrecarga del proveedor), no se cobra nada: los créditos se reservan antes de que el modelo se ejecute y la reserva se devuelve en caso de fallo.

Antes de la llamada, la pasarela reserva una estimación a partir de tu payload a razón de unos 4 caracteres por token. Tras la llamada liquida contra el recuento real de tokens de entrada del informe de uso del modelo, así que la entrada del ledger refleja la verdad, no la estimación. Puedes ver los tres números — estimación, real, cargo — en usage.input_tokens, usage.credits y el ledger.

Ejemplos calculados en tamaños reales

• Comprobación sí/no sobre un ticket de una línea, ~150–300 tokens de entrada → 1 crédito.
• Triaje de soporte: ticket más tres preguntas (sí/no de urgencia, choice de enrutamiento, score de frustración), ~400–500 tokens → 1 crédito.
• Guardarrail de agente sobre una llamada a herramienta JSON con un párrafo de política en el estado, ~1.600 tokens → 2 créditos.
• Filtrado de currículums con un CV completo en el estado, ~8.000 tokens → 8 créditos.

La regla de agrupamiento escondida en esas cifras: como el mínimo es por solicitud y no por pregunta, hasta 8 preguntas sobre el mismo estado no cuestan más de 1 crédito siempre que el total se mantenga por debajo de 1.000 tokens. Dividir el mismo trabajo en llamadas por pregunta cuesta varias veces más.

Los packs

• Starter — $10 → 100.000 créditos. $0,0001 por decisión de crédito mínimo.
• Pro — $100 → 1.000.000 de créditos. Mismo precio por crédito; la ventaja son límites de tasa más altos (600 frente a 120 req/min, 10 frente a 3 concurrentes) y menos recargas.
• Team — $1.000 → 11.000.000 de créditos. Un bono del 10% más colaboración: los compañeros invitados comparten el saldo.
• Free — cada workspace nuevo empieza con 5 créditos, y el playground es gratis en el navegador (nunca toca los créditos).

Los créditos nunca caducan y nunca se mueven entre workspaces. Un mes tranquilo cuesta $0 — no hay suscripción a la que ajustar tu uso.

Límites de tasa por plan

La concurrencia y las solicitudes por minuto siguen al mejor plan del workspace:

• Free: 20 req/min, 1 solicitud concurrente.
• Starter: 120 req/min, 3 concurrentes.
• Pro: 600 req/min, 10 concurrentes.
• Team: 2.000 req/min, 30 concurrentes.
• Enterprise: 6.000 req/min, 100 concurrentes — bajo acuerdo.

Exceder cualquiera de los dos límites devuelve 429 con una cabecera Retry-After más X-RateLimit-Remaining y X-RateLimit-Reset — la señal segura para reintentar que indica cuándo retroceder.

Presupuestar a partir del tráfico

Como la facturación es determinista — solo recuento de tokens — tu factura es predecible: decisiones diarias × créditos medios por decisión. Si la mitad de tus decisiones van sobre el mínimo de 1 crédito y se ejecutan 50.000 al día, eso son unos 50.000 créditos, aproximadamente $5/día a precios Starter. Cargar el pack Team recorta el precio efectivo por crédito en alrededor de un tercio (11M de créditos por $1.000 frente a 1M por $100).

Dos hábitos contables que ahorran dinero

Primero, agrupa tus preguntas. Si una solicitud lleva un sí/no más un choice y un score sobre el mismo estado (triaje de soporte como una sola solicitud), se factura una vez bajo el mínimo de 1 crédito. Enviar los mismos tres como tres solicitudes factura 3 créditos. Hasta ocho preguntas viajan juntas, así que ensambla el estado una vez y pregunta todo sobre lo que podrías ramificar.

Segundo, recorta el estado, no las preguntas. La facturación cuenta los tokens de entrada de todo el payload, así que pegar un documento de 20.000 caracteres en el estado para hacerle una pregunta de una línea domina la factura — ceil(20.800/1.000) = 21 créditos en lugar de 1. Si solo importa un párrafo, extrae tú mismo el párrafo antes de enviar; el modelo hace la lectura que le ordenas, pero el recuento de tokens lo eliges tú.

Cuándo dos créditos ganan a uno

• Un documento de política de 2.400 tokens que se trae una vez y se reutiliza en varias decisiones — si haces tres preguntas en una sola solicitud sobre él, pagas 3 créditos una vez en lugar de reenviarlo en tres llamadas de una sola pregunta (9 créditos por el mismo trabajo).
• Un currículum de ~8.000 tokens filtrado una vez para 8 imprescindibles: 8 créditos en una sola solicitud con 8 preguntas, frente a 8 llamadas a 8 créditos cada una si el estado tuviera que viajar en cada solicitud por separado...
• En realidad esa comparación se repite: el estado solo viaja en las solicitudes que lo necesitan. La palanca real es el mínimo de 1 crédito: por debajo de 1.000 tokens, las preguntas extra son gratis; por encima, cada kilobyte de estado son otros 0,25 créditos.

Qué aparece en el ledger

Cada solicitud liquidada escribe una fila en el ledger del dashboard: reserva (estimación), cargo (tokens de entrada reales / 1000, mínimo 1), request_id, y qué clave de API lo gastó. Las solicitudes fallidas escriben una fila de reembolso con cargo cero, así que la conciliación de fin de mes es solo filtrar por request_id. Si un cargo parece incorrecto, soporte puede rastrearlo desde el request_id de tus registros — citándolo.