Help & Troubleshooting

Contact

For issues with maKI, contact:
Philipp Hematty — philipp.hematty@uni-mannheim.de

Support hours: Mon–Fri, 09:00–17:00 (best effort, no guaranteed response time).

Escalation: Alexander Pfister (department head).

Common errors

401 Unauthorized

{ "error": { "message": "Invalid API key", "code": 401 } }

• Check that the API key is correctly set in the Authorization header: Bearer sk-...
• Key expired or revoked? Contact support for a new key.

404 Model not found

{ "error": { "message": "Model not found", "code": 404 } }

• Check the model name — see Available Models for the current list.
• Model names are case-sensitive.

429 Rate Limit

{ "error": { "message": "Rate limit exceeded", "code": 429 } }

• Your key has hit its request limit. Wait briefly and retry.
• Per-key limits are documented under API Keys.

503 Service Unavailable

• The service is temporarily unreachable (e.g. maintenance or GPU restart).
• Try again in a few minutes.
• If the outage persists, contact support.

Timeout / slow responses

• Large models and long prompts require more compute time.
• Use stream: true for incremental output.
• Reduce max_tokens if possible.

Check service status

The health endpoint shows whether the service is reachable:

curl https://maki.uni-mannheim.de/health

Maintenance announcements

Planned maintenance is announced at least 3 business days in advance by email to all API key holders.