> ## Documentation Index > Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt > Use this file to discover all available pages before exploring further. # Estimar una ejecución > Calcula el precio de una ejecución antes de iniciarla y devuelve el `estimateToken` que la inicia. No se escribe nada. Es obligatorio antes de cada ejecución. ## OpenAPI ````yaml /es/docs-openapi.json post /v1/benchmarks/{id}/estimate openapi: 3.1.0 info: title: API REST de Zelto version: v1 description: >- Acceso programático a tu organización de Zelto. Cada endpoint está limitado a la organización a la que pertenece la clave de API. Crea una clave en Configuración → Integraciones → Integración por API. servers: - url: https://api.zelto.ai description: Producción security: - bearerAuth: [] tags: - name: Monitors description: Exportaciones filtradas y asíncronas de resultados guardados de monitores. - name: Agentes description: >- Agentes de IA de voz y texto normalizados mediante el flujo de ingestión de Zelto. - name: Conversaciones description: >- Conversaciones de voz y texto (llamadas, chats y mensajes de voz), junto con sus transcripciones y grabaciones. - name: Métricas del cliente description: >- Evaluaciones proporcionadas por el cliente y asociadas a una conversación. Requiere que las métricas estén habilitadas. - name: Revisiones description: Estado de revisión humana de las conversaciones. - name: Colas de revisión description: Agrupa y dirige conversaciones para revisarlas por lotes. - name: Empresas description: Clientes o marcas para los que trabajan tus agentes, y sus logos. - name: Hallazgos description: >- Problemas estructurados descubiertos durante el análisis, con conversaciones y comentarios opcionales. - name: Experimentos description: >- Medición prospectiva de dos versiones de prompt enrutadas externamente mediante resultados de monitores independientes. - name: Organizaciones description: >- Aprovisionamiento de organizaciones sin interfaz. Requiere una clave de API de administrador o servicio. - name: Proveedores de IA description: >- Las claves propias de tu organización para proveedores de IA (trae tu propia clave). Los monitores pueden ejecutarse con ellas en lugar de los modelos integrados de Zelto. Solo propietarios o administradores; el secreto es de solo escritura. - name: Benchmarks description: >- Evaluaciones repetibles de prompts, modelos y motores de voz a texto de tus agentes sobre un conjunto fijo de casos, puntuadas por Judges. paths: /v1/benchmarks/{id}/estimate: post: tags: - Benchmarks summary: Estimar una ejecución description: >- Calcula el precio de una ejecución antes de iniciarla y devuelve el `estimateToken` que la inicia. No se escribe nada. Es obligatorio antes de cada ejecución. operationId: estimateBenchmarkRun parameters: - name: id in: path required: true description: Id del benchmark. schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object properties: candidates: minItems: 1 maxItems: 10 type: array items: type: object properties: model: type: string minLength: 1 maxLength: 200 description: >- Un `model` de las opciones de candidatos: "openai/gpt-5-mini", "bedrock/…", o para STT "deepgram/nova-3". agentVersionId: description: >- Solo LLM: la versión del prompt del agente a probar. Null = el prompt tal como se grabó en cada caso. anyOf: - type: string format: uuid - type: 'null' aiKeyId: description: >- Ejecutar con esta clave de IA de la organización (clave propia). Omítelo para usar el modelo de la plataforma. anyOf: - type: string format: uuid - type: 'null' label: description: 'Etiqueta visible. Por defecto: modelo + versión.' type: string maxLength: 200 required: - model description: Lo que compara la ejecución, en orden de visualización. repeats: description: Repeticiones por caso (LLM, 1-3). STT siempre 1. type: integer minimum: 1 maximum: 3 versionNumber: description: >- Versión publicada a ejecutar. Por defecto: la versión publicada actual (o el borrador si no hay nada publicado). type: integer minimum: 1 draft: description: >- Ejecutar el borrador sin publicar en lugar de una versión publicada. type: boolean required: - candidates responses: '200': description: Respuesta correcta. content: application/json: schema: $ref: '#/components/schemas/BenchmarkRunEstimate' '400': $ref: '#/components/responses/ValidationFailed' '401': $ref: '#/components/responses/Unauthorized' '403': description: >- `phi_mode_blocked`: La organización está en modo PHI, que solo permite modelos enrutados por Bedrock y AWS Transcribe. content: application/json: schema: $ref: '#/components/schemas/BenchmarkError' '404': $ref: '#/components/responses/NotFound' '409': description: '`conflict`: El recurso no está en un estado que permita esto.' content: application/json: schema: $ref: '#/components/schemas/BenchmarkError' components: schemas: BenchmarkRunEstimate: type: object properties: estimateToken: type: string description: >- Envíalo sin cambios para iniciar la ejecución. De un solo uso; vence en 15 minutos. benchmarkId: type: string versionNumber: type: - number - 'null' isDraftRun: type: boolean repeats: type: number caseCount: type: number cellCount: type: number perCandidate: type: array items: type: object properties: model: type: string agentVersionId: type: - string - 'null' cells: type: number unitCostUsd: type: number description: USD. costUsd: type: number description: USD. required: - model - agentVersionId - cells - unitCostUsd - costUsd additionalProperties: {} totalCostUsd: type: number description: >- Lo que factura Zelto (costo de la plataforma más margen, más las tarifas por clave propia). warnings: type: array items: type: string unverifiedReferences: description: >- STT: casos que se puntúan contra una transcripción de referencia que nadie revisó todavía (advertencia `unverified_references`). type: integer missingVariables: description: >- LLM: casos cuyo prompt usa una `{{variable}}` que no completan (advertencia `missing_variables`). anyOf: - type: object properties: pairs: type: integer description: >- Pares de caso × candidato que fallarán con `missing_variable:` a $0, antes de llamar al modelo. cells: type: integer description: Sus celdas (pares × repeticiones). names: type: array items: type: string description: >- Los nombres de las variables faltantes, las más frecuentes primero. required: - pairs - cells - names additionalProperties: {} - type: 'null' planLimits: type: array items: type: object properties: code: type: string const: plan_limit cap: type: string description: >- `cells_per_run` (incluye el máximo absoluto de 5.000), `runs_per_month` o `concurrent_runs`. limit: type: number current: type: number requested: type: number required: - code - cap - limit - current - requested additionalProperties: {} description: >- Límites del plan que superaría iniciar esta ejecución. Si no está vacío, agrega la advertencia `plan_limit`; iniciar devuelve 403 `plan_limit`. canStart: type: boolean description: >- False cuando iniciar ahora sería rechazado (un límite del plan, o el gasto en `blocked`). candidates: type: array items: type: object properties: label: type: string model: type: string agentVersionId: type: - string - 'null' agentVersionLabel: type: - string - 'null' aiKeyId: type: - string - 'null' billedBy: type: string enum: - zelto - byok required: - label - model - agentVersionId - agentVersionLabel - aiKeyId - billedBy additionalProperties: {} billing: type: object properties: typicalCostUsd: type: number description: USD. billedByYourKeysUsd: type: number description: Facturado a tus propias claves de proveedor, no por Zelto. costCapUsd: type: number description: El límite estricto de la ejecución (1,5 × la estimación). expiresAt: type: string required: - typicalCostUsd - billedByYourKeysUsd - costCapUsd - expiresAt additionalProperties: {} spend: type: object properties: decision: type: string enum: - allowed - approval_required - blocked description: Qué pasaría si la inicias ahora. reason: anyOf: - type: string enum: - monthly_cap - threshold - free_credit_exhausted - type: 'null' monthToDateUsd: type: number description: USD. monthlyCapUsd: anyOf: - type: number description: USD. - type: 'null' creditRemainingUsd: type: number description: USD. required: - decision - reason - monthToDateUsd - monthlyCapUsd - creditRemainingUsd additionalProperties: {} required: - estimateToken - benchmarkId - versionNumber - isDraftRun - repeats - caseCount - cellCount - perCandidate - totalCostUsd - warnings - planLimits - canStart - candidates - billing - spend additionalProperties: {} description: Un plan de ejecución con precio, más el token que la inicia. BenchmarkError: type: object required: - error - code - message properties: error: type: string enum: - validation_failed - invalid_parameter - approval_required - plan_limit - phi_mode_blocked - owner_required - not_entitled - forbidden - not_found - payload_too_large - estimate_stale - pointer_moved - no_draft_changes - conflict - idempotency_key_reused - rate_limited - model_unavailable description: Código de error estable (mismo valor que `code`). code: type: string enum: - validation_failed - invalid_parameter - approval_required - plan_limit - phi_mode_blocked - owner_required - not_entitled - forbidden - not_found - payload_too_large - estimate_stale - pointer_moved - no_draft_changes - conflict - idempotency_key_reused - rate_limited - model_unavailable description: Causa estable y legible por máquinas; compara con este campo. message: type: string description: Una frase en lenguaje claro que explica qué está mal. hint: type: string description: El siguiente paso que conviene probar. details: type: object additionalProperties: true description: >- Contexto propio de cada código, por ejemplo `approvalRequestId` con `approval_required` o `cap` con `plan_limit`. Error: type: object required: - error properties: error: type: string description: >- Nombre corto del error: `Unauthorized`, `Validation failed`, `Not found` o un código estable en snake_case que puedes comparar en tu código, como `unknown_query_parameter`, `invalid_parameter`, `payload_too_large` o `not_found`. message: type: string description: Una frase en lenguaje claro que explica qué falla y cómo corregirlo. code: type: string description: >- Causa estable y legible por máquina; compara con este valor y no con `error` ni `message`. En un 401: `missing_credentials`, `malformed_credentials`, `ingest_key_not_allowed` (se usó una clave de ingesta de observabilidad, solo de escritura, en un endpoint que requiere una clave API), `key_expired` o `invalid_credentials`. En otros casos, por ejemplo: `not_found`, `invalid_parameter`, `unknown_query_parameter`, `missing_parameter`, `validation_failed`, `invalid_json`, `payload_too_large`, `conversation_not_found`, `plan_required`. hint: type: string description: >- El siguiente paso a probar: dónde encontrar el id correcto, qué parámetros acepta el endpoint, cómo mejorar el plan o cómo autenticarte. parameter: type: string description: 'Con `invalid_parameter`: el parámetro de consulta rechazado.' unknown: type: array items: type: string description: >- Con `unknown_query_parameter`: los parámetros enviados que este endpoint no acepta. valid: type: array items: type: string description: >- Con `unknown_query_parameter`: los parámetros que acepta este endpoint. details: type: object additionalProperties: true responses: ValidationFailed: description: >- El cuerpo o la cadena de consulta de la solicitud han fallado en la validación. `code` indica el tipo (`validation_failed`, `invalid_json`, `invalid_parameter`, `unknown_query_parameter`, `missing_parameter`) y un filtro con valores fijos lista los permitidos en `valid` (se comprueba cada valor repetido: `?status=open&status=zz` es un 400). Un cuerpo `validation_failed` incluye además `message` (los primeros campos que fallan), `hint` (cómo corregirlo, por ejemplo que la `description` de un hallazgo es un documento JSON de TipTap y no una cadena) y `details` (nombre del campo y mensajes). content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: >- Clave API faltante o no válida. El cuerpo indica la causa en `code` (por ejemplo `ingest_key_not_allowed` cuando se usa aquí una clave de ingesta, solo de escritura), con un `message` y un `hint`. content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: >- Recurso no encontrado en tu organización. También se devuelve cuando un id de la ruta no es un UUID, y `{ "error": "not_found" }` para una ruta que esta API no tiene. El cuerpo conserva `error: "Not found"` y añade `code: "not_found"` y un `hint`. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Envía `Authorization: Bearer YOUR_API_KEY`. La clave corresponde a una sola organización. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.