Troubleshooting Checklist
Verify your API key
Confirm that you are sending the correct API key and that it has not expired. Call
GET /v1/dashboard/billing/subscription to check your account status. A 401 error almost always means an invalid or expired key.Check your request format
Ensure all required parameters are present, that
Content-Type: application/json is set for JSON endpoints, and that your JSON body is valid. Use "stream": false when debugging to get a complete response at once.Confirm the model ID
Call
GET /v1/models and verify the exact model id you are passing. Model IDs are case-sensitive.Review rate limits
If you are receiving
429 errors, you have exceeded your rate limit. Wait before retrying and implement exponential backoff. Contact support if you need higher limits.Common Error Reference
| HTTP Status | Error Code | Resolution |
|---|---|---|
401 | invalid_api_key | Check your API key value and ensure it is prefixed with Bearer in the header |
400 | invalid_request_error | Check required fields and parameter types in your request body |
429 | rate_limit_exceeded | Implement exponential backoff; contact support to increase limits |
500 | server_error | Retry after a short delay; report if it persists |
Contact Support
If the troubleshooting steps above do not resolve your issue, reach out through any of these channels:QQ Group
Join QQ group 712747875. After joining, send a direct message to the group owner for personalized assistance.
Send a detailed description of your issue to support@qhaigc.net. Include your error response, the endpoint you called, and a sanitized version of your request (remove the API key).