Quick Start Your First Call
Common Errors
The most common authentication, permission, model, and parameter issues during first integration
| Symptom | Likely Cause | What to Check |
|---|---|---|
401 | API Key is missing, incorrect, or not passed as a bearer token. | Use the full sk-... secret and the correct Authorization header or client API Key field. |
403 | Token, group, model, or IP permission is restricted. | Check token status, model allowlist, group, source IP, and expiration. |
| Model not found | The model ID is wrong or not available to this token. | Copy the model ID from Model Gallery or /v1/models, then confirm token restrictions. |
| Insufficient balance | Account balance or token quota is not enough. | Check Dashboard, Top Up Balance, and token quota. |
| Bad request | Request body does not match the selected endpoint protocol. | Do not mix OpenAI-style, Claude Messages, and Gemini-native payloads. |
| Timeout | The model or task takes longer than the client timeout. | Increase client timeout or use async task endpoints when applicable. |
| Rate limited | Request frequency exceeds current limits. | Check RPM/TPM in Operation Records and reduce concurrency. |
When troubleshooting, start from the smallest reproducible request, then compare the Base URL, path, API Key, model ID, and payload against the matching documentation page.
How is this guide?
Last updated on