Skip to main content

Troubleshooting

Common issues and solutions for ZQ Platform APIs.

Authentication Issues​

401 Unauthorized​

Problem: {"detail": "Invalid or missing API key"}

Solutions:

  1. Check your API key is set correctly: 
    echo $ZQ_API_KEY
  2. Ensure the header is correct: x-api-key (not Authorization)
  3. Verify there are no extra spaces or quotes in your key

403 Forbidden​

Problem: {"detail": "Insufficient tier for resource"}

Solutions:

  1. Check your current tier: GET /v1/usage/me
  2. Contact contact@zettaquant.ai to upgrade

Rate Limiting​

429 Too Many Requests​

Problem: Rate limit exceeded

Solutions:

  1. Check your usage: GET /v1/usage/me
  2. Implement exponential backoff: 
    import time

    for attempt in range(3):
        response = make_request()
        if response.status_code == 429:
            time.sleep(2 ** attempt)
            continue
        break
  3. Batch requests (up to 100 texts per inference call)

Common Errors​

Invalid Model ID​

Problem: {"detail": "Model not found: xyz"}

Solution: List available models first:

curl -H "x-api-key: $ZQ_API_KEY" $ZQ_BASE_URL/v1/models

Invalid Bank Name​

Problem: {"detail": "Invalid filter value for bank_name"}

Solution: Use exact values from the Available Central Banks list.

Getting Help​