Troubleshooting
Common issues
Provider request fails
Checklist:
- Verify selected provider key (for example
openai_) is set.api_ key - Verify selected model value is valid for that provider.
- Verify endpoint URL for custom/azure setups.
- Review
sys_entries written bylog Ai.Log Service
HTTP 401 / 403 when fetching protected URL
Checklist:
- Enable
basic.Auth Enabled - Set both
basicandAuth Username basic.Auth Password - Re-test URL using
Http.Auth Utility
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_is available.statistics
Unexpected model behavior
- Confirm active default model key.
- Confirm per-provider model key.
- Validate option values (temperature/tokens) are in expected range.
Operational guidance
- 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
When escalating an issue, provide:
- TYPO3 version
- extension version
- provider name and model
- timestamp and scope/module
- sanitized error message from logs