> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check judge generation settings against the model

> Sends one small completion to the given judge model with the given generation settings, so a rejected value surfaces while a metric is being configured rather than after an evaluation has run. The gateway publishes which settings a model takes but never their legal values, so the provider is the only judge of them. Persists nothing and consumes no credits.



## OpenAPI

````yaml https://api.galtea.ai/openapi.json post /evaluatorModels/test-generation-settings
openapi: 3.0.0
info:
  version: 1.0.0
  title: Product Management Service API
  description: API documentation for Product Management Service
  contact:
    name: Galtea AI
servers:
  - url: https://api.galtea.ai
security:
  - bearerAuth: []
tags: []
externalDocs:
  description: Galtea Platform Documentation
  url: https://docs.galtea.ai
paths:
  /evaluatorModels/test-generation-settings:
    post:
      tags:
        - evaluator-models
      summary: Check judge generation settings against the model
      description: >-
        Sends one small completion to the given judge model with the given
        generation settings, so a rejected value surfaces while a metric is
        being configured rather than after an evaluation has run. The gateway
        publishes which settings a model takes but never their legal values, so
        the provider is the only judge of them. Persists nothing and consumes no
        credits.
      operationId: testEvaluatorModelGenerationSettings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TestGenerationSettingsBody'
      responses:
        '200':
          description: >-
            The probe ran. `outcome` says whether the provider accepted the
            settings, refused one, or never answered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerationSettingsTestResult'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    TestGenerationSettingsBody:
      type: object
      properties:
        evaluatorModelName:
          type: string
          minLength: 1
          example: gpt-5-nano
          description: >-
            The judge model to send the probe to. Must be a model a metric may
            select.
        judgeGenerationSettings:
          type: object
          nullable: true
          properties:
            temperature:
              type: number
              nullable: true
              minimum: 0
              example: 0.3
            topP:
              type: number
              nullable: true
              minimum: 0
              maximum: 1
              example: 0.9
            maxOutputTokens:
              type: integer
              nullable: true
              minimum: 1
              example: 512
            reasoningEffort:
              type: string
              nullable: true
              example: low
          additionalProperties: false
          description: >-
            The settings to try. Omit a setting to leave the provider default in
            place.
      required:
        - evaluatorModelName
    GenerationSettingsTestResult:
      type: object
      properties:
        outcome:
          type: string
          enum:
            - accepted
            - refused
            - unreachable
          example: accepted
          description: >-
            What the call established. `accepted` means the provider took the
            values; a setting a model does not support is discarded silently and
            still counts as accepted, so this never reports that a value changed
            the judge behaviour. `refused` means the provider was reached and
            rejected a value. `unreachable` means the provider never answered,
            so nothing was learned about the values and the call is worth
            repeating.
        error:
          type: string
          nullable: true
          example: 'temperature: range: 0..1'
          description: >-
            The provider's own refusal message, naming the parameter and its
            limit. Set only on `refused`: an `unreachable` outcome carries no
            message, because the failure is ours and says nothing about the
            values that were sent.
      required:
        - outcome
        - error
    Error:
      type: object
      properties:
        error:
          type: string
          example: Error type
        message:
          type: string
          example: Error message description
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authorization. Pass your API key in the Authorization header as
        a Bearer token. Both new (`gsk_*`) and legacy (`gsk-`) API keys are
        accepted, e.g. `Authorization: Bearer gsk_...` or `Authorization: Bearer
        gsk-...`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.