---
title: "Troubleshooting"
manual: "AI Universe"
version: "1.0"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-aiuniverse:troubleshooting@1.0"
source: "Troubleshooting/Index.rst"
rendered: "2026-10-19T14:06:07+00:00"
---

# Troubleshooting {#troubleshooting}

-   [Common issues](https://docs.typo3.org/permalink/nitsan/ns-aiuniverse:common-issues@1.0)
-   [Operational guidance](https://docs.typo3.org/permalink/nitsan/ns-aiuniverse:operational-guidance@1.0)
-   [Support information](https://docs.typo3.org/permalink/nitsan/ns-aiuniverse:support-information@1.0)

## Common issues {#troubleshooting-common}

### Provider request fails {#provider-request-fails}

Checklist:

-   Verify selected provider key (for example `openai_api_key`) is set.
-   Verify selected model value is valid for that provider.
-   Verify endpoint URL for custom/azure setups.
-   Review `sys_log` entries written by `AiLogService`.

### HTTP 401 / 403 when fetching protected URL {#http-401-403-when-fetching-protected-url}

Checklist:

-   Enable `basicAuthEnabled`.
-   Set both `basicAuthUsername` and `basicAuthPassword`.
-   Re-test URL using `HttpAuthUtility`.

### No statistics shown {#no-statistics-shown}

Checklist:

-   Ensure OpenAI key is configured (admin key preferred for org usage endpoint).
-   Check if API rate limit was hit.
-   Force refresh in consumer module (if available) or clear cache.
-   Confirm cache `nsaiuniverse_statistics` is available.

### Unexpected model behavior {#unexpected-model-behavior}

-   Confirm active default model key.
-   Confirm per-provider model key.
-   Validate option values (temperature/tokens) are in expected range.

## Operational guidance {#troubleshooting-ops}

-   Use separate API keys per environment where possible.
-   Rotate keys after staff/vendor access changes.
-   Monitor usage trends and adjust limits before cost spikes.

## Support information {#troubleshooting-support}

When escalating an issue, provide:

-   TYPO3 version
-   extension version
-   provider name and model
-   timestamp and scope/module
-   sanitized error message from logs