Troubleshooting

Definition

Troubleshooting is a symptom-to-fix list for the most common problems when calling luv13, based on the responses the API actually returns.

Key takeaways

  • First check the API is up: curl -s -o /dev/null -w "%{http_code}\n" https://api.luv13.ai/v1/models should print 200.
  • 401 is almost always the key or the header format.
  • 404 is almost always the URL: the base URL must be exactly https://api.luv13.ai/v1, with no trailing slash on paths.
  • A tool that shows no models or can't connect usually has the wrong base URL.
  • If a model is unavailable, switch to another id.

Symptom and fix

SymptomLikely causeFix
401 with invalid_authKey missing, wrong, or not sent as Authorization: Bearer <key>Re-copy the key from where you stored it; check for a missing Bearer or a trailing newline
404 with an HTML pageWrong path: missing /v1, doubled /v1/v1, a trailing slash, or an endpoint luv13 doesn't serveUse https://api.luv13.ai/v1 as the base URL; see Endpoints
405 with an HTML pageGET sent to /v1/chat/completionsUse POST
522luv13's servers unreachable behind CloudflareWait and retry; see Health Checks
Error naming a model as unavailableThat model is out of capacitySwitch ids; see Model Fallback
Requests slow or failing under loadCapacity saturated; requests queue or failRetry with backoff; see Retrying Requests
CORS error in the browser consoleluv13 rejects cross-origin browser callsCall luv13 from your server; see Browser Requests
JSON parse error in your codeThe error body was HTML (404 or 405)Check the status code before parsing
Tool feature fails, chat worksThe feature uses an endpoint luv13 doesn't serve, such as embeddingsTurn that feature off, or use another service for it

Base URL mistakes

Many tools add /chat/completions to whatever you enter. Enter the base URL, not the full endpoint:

You enterTool callsResult
https://api.luv13.ai/v1https://api.luv13.ai/v1/chat/completionsWorks
https://api.luv13.aihttps://api.luv13.ai/chat/completions404
https://api.luv13.ai/v1/chat/completions.../v1/chat/completions/chat/completions404

Still stuck

Email [email protected] with the time, endpoint, model id, status code and error body. See Contact and Support.