Configuration

Models and connection test

Verify the endpoint, retrieve models and diagnose an unavailable provider.

Procedure

  1. Choose the provider.
  2. Verify the base URL.
  3. Enter the key if required.
  4. Run the connection test.
  5. Select a model actually returned by the provider, or enter its exact identifier.
  6. Run a short test in the sandbox.

A successful connection test does not prove that a complete book will succeed: it mainly confirms that the endpoint responds and accepts authentication.

Automatic discovery

For compatible APIs, TraDoc requests the model list. Some providers do not expose this endpoint or filter results by account; in that case, use the identifier documented by the provider.

Local endpoint unreachable

  • Check that the LLM server is running.
  • Allow network requests in LM Studio or Ollama if TraDoc runs on another machine.
  • From Docker, replace localhost with the host address defined by your Compose configuration.
  • Do not expose the model port directly to the Internet.

Allowed host list

ALLOWED_LLM_HOSTS can restrict the destinations the backend may access. When set, the endpoint host must appear in that list.

Providers

Remote services, local engines and provider-specific settings.

Translation engine

Segment size, concurrency, temperature, retries and prompt caching.