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.
Last updated on