> ## 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.

# Inspecionar um Endpoint

> Obtenha os schemas, o Price atual e um exemplo de entrada de um Endpoint. Use esses detalhes para preparar um Run.

Use `input_schema` para preparar sua solicitação e revisar o Price antes de executá-la. Salve `endpoint_version` para o Run; ele não bloqueia o Price. Para Endpoints síncronos, configure o timeout do cliente acima de `timeout_ms`.


## OpenAPI

````yaml /openapi.pt.json post /v1/endpoints/inspect
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas
    adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro
    contém o mesmo envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/endpoints/inspect:
    post:
      tags:
        - Endpoints
      summary: Inspecionar um endpoint
      description: >-
        Obtenha o esquema de entrada de um endpoint, o esquema de saída
        disponível, o preço, uma entrada de exemplo, a versão, o modo de
        execução e o tempo limite. Faça a inspeção antes do primeiro Run e use
        os valores retornados de input_schema e endpoint_version.


        Um output_schema nulo significa que não há um esquema confiável
        disponível. As versões do endpoint não fixam o preço: novos Runs usam o
        preço vigente na admissão. Para endpoints síncronos, defina o tempo
        limite do seu cliente HTTP acima 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: >-
                        Selecione uma versão compatível do endpoint, inclusive
                        uma versão anterior, ou omita-a para usar o padrão.
                        Versões indisponíveis ou retiradas retornam 409.
                    - type: 'null'
                task_id:
                  anyOf:
                    - type: string
                      description: >-
                        A tarefa à qual esta inspeção pertence, obtida de uma
                        resposta de busca do catálogo. Qualquer string estável é
                        aceita.
                    - 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 rastreamento opcionais, retornados no Run e
                        disponíveis como filtros. Eles nunca são enviados ao
                        provedor de dados nem afetam o roteamento, o preço ou a
                        idempotência.


                        - Até 20 chaves: letras minúsculas, dígitos e
                        sublinhados; devem começar com uma letra; no máximo 40
                        caracteres.

                        - Valores: strings de 1 a 500 caracteres.

                        - user_id: o ID opaco do seu usuário final, nunca o
                        endereço de e-mail ou o nome.


                        Entradas inválidas são descartadas por inteiro, não
                        truncadas. A solicitação continua, e o Run retorna os
                        campos armazenados.
                    - type: 'null'
              required:
                - provider
                - endpoint
              additionalProperties: false
        required: true
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  provider:
                    type: string
                    pattern: ^[a-z0-9][a-z0-9-]*$
                  provider_label:
                    type: string
                    description: >-
                      O nome da marca do provedor de dados, para exibição:
                      "People Data Labs" para o provedor "pdl". A identidade
                      permanece em `provider` — esse é o valor usado por Run e
                      inspect, e este nunca é enviado de volta.
                  endpoint:
                    type: string
                    pattern: ^\/.+$
                  endpoint_version:
                    type: integer
                    exclusiveMinimum: 0
                    description: >-
                      Versão compatível do endpoint. Atualizações compatíveis
                      mantêm esta versão.
                  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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                            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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              cap_usd:
                                anyOf:
                                  - type: string
                                    pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                    description: >-
                                      String decimal exata em USD (mínimo de 2 e
                                      máximo de 6 casas decimais, com uma única
                                      grafia canônica). Some usando aritmética
                                      decimal ou escale por 10^6 — nunca use
                                      números de ponto flutuante.
                                  - type: 'null'
                              partial_usd:
                                type: string
                                pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                description: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                            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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              cap_usd:
                                type: string
                                pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                description: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                            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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              cap_usd:
                                type: string
                                pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                description: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              cap_usd:
                                anyOf:
                                  - type: string
                                    pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                    description: >-
                                      String decimal exata em USD (mínimo de 2 e
                                      máximo de 6 casas decimais, com uma única
                                      grafia canônica). Some usando aritmética
                                      decimal ou escale por 10^6 — nunca use
                                      números de ponto flutuante.
                                  - 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: >-
                                        String decimal exata em USD (mínimo de 2
                                        e máximo de 6 casas decimais, com uma
                                        única grafia canônica). Some usando
                                        aritmética decimal ou escale por 10^6 —
                                        nunca use números de ponto flutuante.
                                    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: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                              cap_usd:
                                type: string
                                pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                                description: >-
                                  String decimal exata em USD (mínimo de 2 e
                                  máximo de 6 casas decimais, com uma única
                                  grafia canônica). Some usando aritmética
                                  decimal ou escale por 10^6 — nunca use números
                                  de ponto flutuante.
                            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: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                          unit:
                            type: string
                          cap_usd:
                            type: string
                            pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                            description: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                        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: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                          PROVIDER_ERROR:
                            type: string
                            pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                            description: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                          TIMED_OUT:
                            type: string
                            pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                            description: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                          INTERNAL:
                            type: string
                            pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                            description: >-
                              String decimal exata em USD (mínimo de 2 e máximo
                              de 6 casas decimais, com uma única grafia
                              canônica). Some usando aritmética decimal ou
                              escale por 10^6 — nunca use números de ponto
                              flutuante.
                        required:
                          - NO_RESULT
                          - PROVIDER_ERROR
                          - TIMED_OUT
                          - INTERNAL
                        additionalProperties: false
                    required:
                      - rule
                      - display
                      - charges
                    additionalProperties: false
                    description: >-
                      Preço atual e regras de cobrança. O preço pode mudar sem
                      alteração da versão do endpoint. Novos Runs usam o preço
                      vigente na admissão; Runs aceitos mantêm esse preço.
                  run_mode:
                    type: string
                    enum:
                      - sync
                      - async
                  timeout_ms:
                    anyOf:
                      - type: integer
                        exclusiveMinimum: 0
                        description: >-
                          Para endpoints síncronos, o tempo máximo, em
                          milissegundos, entre uma solicitação de Run e sua
                          resposta terminal. Defina o tempo limite do seu
                          cliente HTTP acima desse 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 do provedor de dados para a entrada do
                      Run.
                  output_schema:
                    anyOf:
                      - type: object
                      - type: 'null'
                    description: >-
                      JSON Schema para uma saída bem-sucedida. Nulo quando não
                      há um esquema confiável disponível; respostas de exemplo
                      não definem um esquema.
                  output_schema_source:
                    anyOf:
                      - type: string
                        enum:
                          - provider
                          - glasser
                      - type: 'null'
                    description: >-
                      Quem define o esquema de saída: o provedor de dados ou o
                      Glasser. Nulo quando output_schema é nulo.
                  sample_input:
                    type: object
                    description: >-
                      Entrada de exemplo. Ajuste-a à sua solicitação e valide-a
                      em relação a input_schema.
                  doc_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: >-
                      Link para a documentação do provedor de dados, quando
                      disponível.
                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.