API de decisiones

Elige un modelo de decisión

Las solicitudes existentes siguen usando Jev. La URL, clave API, tipos y respuestas Jev no cambian. Agrega model: "clef" para usar Clef; omite model o usa "jev" para Jev.

Jev: 1 crédito por cada 1,000 tokens de entrada iniciados. Clef: 1 por cada 100. Mínimo: 1 crédito. La pregunta y los criterios también cuentan como tokens de entrada.

Jev reserva hasta 32 créditos disponibles y requiere al menos 1. Clef estima la reserva según el texto completo y las dimensiones de las imágenes; el saldo debe cubrirla. El cobro usa los tokens reales sin superar la reserva. Se libera el sobrante e iajev cubre cualquier subestimación. Los fallos no se cobran.

Texto: JSON de state y preguntas mapeadas al modelo, con etiquetas y descripciones; max(caracteres Unicode × 2, bytes UTF-8) + 200 tokens. Imágenes: cuadrícula de 32 píxeles tras ampliar a un mínimo de 65,536 píxeles, margen del 25 % y 16 tokens por imagen. Total limitado a 65,536 tokens; créditos redondeados hacia arriba por cada 100. Es una estimación, no un tokenizer. GET /api/v1/models indica versión, parámetros y reserva máxima, con reservationMode, maxReservationCredits, estimation y chargeCappedAtReservation en lugar de los campos fijos reservationCredits/minimumAvailableCredits.

Jev conserva 8,000 caracteres y 16,000 bytes. Clef acepta hasta 1 MiB de texto JSON con una ventana de 65,536 tokens compartida entre texto, imágenes y pregunta; el estado demasiado largo puede truncarse. Una pregunta, hasta 8 opciones o niveles. Solicitud Clef: hasta 13 MiB, sin video.

Imágenes Clef: images opcional con URL data:image/png;base64,... (también JPEG/WebP) u objetos {content_type, base64}. Hasta 4 imágenes, 4 MiB / 16 MP cada una, 8 MiB decodificados en total. No se aceptan URL remotas. No se guardan imágenes en el historial ni en configuraciones; reenvíalas en cada reintento con la misma clave. Tiempo límite: Clef 90 segundos, Jev 15. El formulario carga tres ejemplos fijos del CDN de iajev mediante un servicio interno y los reduce a 512 px. API/MCP siguen requiriendo imágenes integradas; no aceptan URL remotas.

GET /api/v1/models usa tu clave API sin consumir créditos. Revisa available. En MCP, usa list_models gratis y pasa model a run_decision. La autenticación y los permisos no cambian.

Reutiliza la clave de idempotencia si el resultado es incierto. Cambiar de modelo con la misma clave devuelve IDEMPOTENCY_CONFLICT. Las llamadas completadas conservan su resultado y cobro aunque se desactive Clef. No hay sustitución automática de modelos.

Solo Clef agrega meta.model y billing.pricingVersion, estimationVersion, estimatedInputTokens, reservedCredits y waivedCredits. waivedCredits indica la diferencia asumida por iajev; billing.credits es el cargo real. Jev no cambia. MODEL_UNAVAILABLE (503) indica que Clef está deshabilitado.

curl https://iajev.com/api/v1/models -H 'Authorization: Bearer YOUR_API_KEY'

curl https://iajev.com/api/v1/decisions/run \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: clef-example-001' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "clef",
  "state": {
    "message": "Mis pagos han fallado durante tres días. Necesito ayuda hoy."
  },
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="
  ],
  "decision": {
    "type": "noul",
    "question": "¿Esta solicitud requiere atención urgente?"
  }
}'

{
  "model": "clef",
  "state": {
    "message": "Mis pagos han fallado durante tres días. Necesito ayuda hoy."
  },
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="
  ],
  "decision": {
    "type": "noul",
    "question": "¿Esta solicitud requiere atención urgente?"
  },
  "idempotency_key": "clef-example-001"
}

Ejemplos de probabilidad y puntuación

{
  "state": {
    "message": "Mis pagos han fallado durante tres días. Necesito ayuda hoy."
  },
  "decision": {
    "type": "noul",
    "question": "¿Esta solicitud requiere atención urgente?"
  }
}

{
  "decision": 0.95,
  "confidence": null,
  "results": [
    {
      "value": "true",
      "probability": 0.95
    },
    {
      "value": "false",
      "probability": 0.05
    }
  ],
  "meta": {
    "latencyMs": 218,
    "requestId": "…"
  },
  "billing": {
    "credits": 1,
    "inputTokens": 380,
    "outputTokens": 45
  }
}

{
  "state": {
    "message": "Mis pagos han fallado durante tres días. Necesito ayuda hoy."
  },
  "decision": {
    "type": "score",
    "question": "¿Qué tan urgente es esta solicitud?",
    "criteria": [
      "Urgencia baja",
      "Urgencia moderada",
      "Urgencia alta"
    ]
  }
}

{
  "decision": 1.8,
  "confidence": 0.9,
  "results": [
    {
      "value": "Urgencia baja",
      "probability": 0.05
    },
    {
      "value": "Urgencia moderada",
      "probability": 0.1
    },
    {
      "value": "Urgencia alta",
      "probability": 0.85
    }
  ],
  "meta": {
    "latencyMs": 218,
    "requestId": "…"
  },
  "billing": {
    "credits": 1,
    "inputTokens": 380,
    "outputTokens": 45
  }
}