AI providers and connection tests

Chess with any AI supports configured OpenAI-compatible chat endpoints. Some providers are offered as presets; compatible endpoints can also use a custom base URL and model.

Test before you play

Test connection uses the selected profile, model, and key to request a move for a real chess position. A successful test means the app can reach that model and interpret a legal response.

Resilient move handling

Models do not all implement the same response-format features. The app uses a compact move contract, accepts supported text responses, and locally validates the result against the live board. If a provider rejects an optional response feature, the app retries with a compatible request shape.

If a model still cannot make a move, the board remains unchanged. You can retry the move or switch the AI profile for that seat.

Troubleshooting

  • Verify the API key belongs to the provider you selected.
  • Confirm the model ID and base URL in the AI profile.
  • Run Test connection after changing any provider setting.
  • If a provider is slow, raise the profile timeout before starting a timed match.

See Troubleshooting for more.