> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Inspeccionar un Endpoint > Obtén los esquemas, el Price actual y un ejemplo de entrada de un Endpoint. Usa estos detalles para preparar un Run. Usa `input_schema` para preparar tu solicitud y revisar el Price antes de ejecutarla. Guarda `endpoint_version` para el Run; no bloquea el Price. Para Endpoints síncronos, configura el tiempo de espera del cliente por encima de `timeout_ms`. ## OpenAPI ````yaml /openapi.es.json post /v1/endpoints/inspect openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Una API Key, sin contrato, con pago por llamada, para APIs de pago adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de error incluye el mismo sobre. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/endpoints/inspect: post: tags: - Endpoints summary: Inspeccionar un endpoint description: >- Obtenga el esquema de entrada de un endpoint, el esquema de salida disponible, el Price, una entrada de ejemplo, la versión, el modo de ejecución y el tiempo de espera. Haga la inspección antes del primer Run y use los valores input_schema y endpoint_version devueltos. Un output_schema con valor null significa que no hay un esquema fiable disponible. Las versiones de los endpoints no fijan el Price: los Runs nuevos usan el Price vigente en el momento de admisión. Para los endpoints síncronos, configure el tiempo de espera de su cliente HTTP por encima de timeout_ms. operationId: endpoints-inspect parameters: [] requestBody: content: application/json: schema: type: object properties: provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: anyOf: - type: integer exclusiveMinimum: 0 description: >- Seleccione una versión compatible del endpoint, incluida una anterior, u omita este campo para usar la predeterminada. Las versiones no disponibles o retiradas devuelven 409. - type: 'null' task_id: anyOf: - type: string description: >- La tarea a la que pertenece esta inspección, proveniente de una respuesta de búsqueda del catálogo. Se acepta cualquier cadena estable. - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: >- Campos de seguimiento opcionales, devueltos en el Run y disponibles como filtros. Nunca se envían al proveedor de datos ni afectan al enrutamiento, al Price ni a la idempotencia. - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra y tener como máximo 40 caracteres. - Valores: cadenas de 1 a 500 caracteres. - user_id: el ID opaco de su usuario final, nunca su dirección de correo electrónico ni su nombre. Las entradas no válidas se descartan por completo, no se truncan. La solicitud continúa y el Run devuelve los campos que se almacenaron. - type: 'null' required: - provider - endpoint additionalProperties: false required: true responses: '200': description: Éxito content: application/json: schema: type: object properties: provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ provider_label: type: string description: >- El nombre de marca del proveedor de datos, para mostrarlo: "People Data Labs" para el proveedor de datos "pdl". La identidad permanece en `provider`: ese es el valor que usan Run e inspect, y este nunca se devuelve. endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 description: >- Versión compatible del endpoint. Las actualizaciones compatibles mantienen esta versión. name: type: string description: type: string tags: type: array items: type: string price: type: object properties: rule: anyOf: - type: object properties: type: type: string enum: - flat amount_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - type - amount_usd additionalProperties: false - type: object properties: type: type: string enum: - per_result per_result_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. cap_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. - type: 'null' partial_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - type - per_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_token per_million_input_tokens_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - type - per_million_input_tokens_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - base_plus_per_result base_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. included_results: type: integer minimum: 0 per_extra_result_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. unit: type: string required: - type - base_usd - included_results - per_extra_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - metered base_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. cap_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. - type: 'null' base_kind: type: string enum: - starting required: - type - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_event events: type: object additionalProperties: type: object properties: usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. title: type: string required: - usd - title additionalProperties: false base_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - type - events - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string required: - type allOf: - type: object additionalProperties: {} display: type: object properties: amount_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. unit: type: string cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - amount_usd - unit additionalProperties: false charges: type: object properties: NO_RESULT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. PROVIDER_ERROR: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. TIMED_OUT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. INTERNAL: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, una única representación canónica). Sume mediante aritmética decimal o escale por 10^6; nunca use números de coma flotante. required: - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL additionalProperties: false required: - rule - display - charges additionalProperties: false description: >- Price y reglas de cobro actuales. El Price puede cambiar sin que cambie la versión del endpoint. Los Runs nuevos usan el Price vigente en el momento de admisión; los Runs aceptados conservan ese Price. run_mode: type: string enum: - sync - async timeout_ms: anyOf: - type: integer exclusiveMinimum: 0 description: >- Para los endpoints síncronos, el tiempo máximo, en milisegundos, desde una solicitud de Run hasta su respuesta terminal. Configure el tiempo de espera de su cliente HTTP por encima de este valor. - type: 'null' client: type: object properties: client_version: anyOf: - type: string - type: 'null' minimum_version: type: string latest_version: type: string upgrade_command: type: string reason: type: string required: - client_version - minimum_version - latest_version - upgrade_command - reason additionalProperties: false method: type: string enum: - GET - POST - PUT - PATCH - DELETE - HEAD input_schema: type: object description: >- JSON Schema nativo del proveedor de datos para la entrada de Run. output_schema: anyOf: - type: object - type: 'null' description: >- JSON Schema para una salida correcta. Es null cuando no hay un esquema fiable disponible; las respuestas de ejemplo no definen un esquema. output_schema_source: anyOf: - type: string enum: - provider - glasser - type: 'null' description: >- Quién define el esquema de salida: el proveedor de datos o Glasser. Es null cuando output_schema es null. sample_input: type: object description: >- Entrada de ejemplo. Adáptela a su solicitud y valídela con input_schema. doc_url: anyOf: - type: string - type: 'null' description: >- Enlace a la documentación del proveedor de datos, cuando esté disponible. required: - provider - provider_label - endpoint - endpoint_version - name - description - tags - price - run_mode - method - input_schema - output_schema - output_schema_source - sample_input - doc_url additionalProperties: false '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFoundEncoded' '409': description: EndpointVersionMismatch content: application/json: schema: $ref: '#/components/schemas/EndpointVersionMismatchEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false NotFoundEncoded: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointVersionMismatchEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_version_mismatch message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.