Error Handling

Error Response Format

When an API request fails, the response body contains error information in the following format:

{
  "error": {
    "message": "Error description",
    "type": "error_type",
    "code": "error_code"
  }
}

Error Code Reference

Retry Strategy

For 429 and 5xx errors, implement exponential backoff retry:

async function callWithRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429 || error.status >= 500) {
        const delay = Math.pow(2, i) * 1000;
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }
      throw error;
    }
  }
  throw new Error('Max retries exceeded');
}

Common Troubleshooting Steps

1. Verify API Key: Check in the console that the key is enabled. Watch for extra spaces when copying.
2. Check Base URL: Ensure it's https://codingplan.alayanew.com/v1 (note the trailing /v1).
3. Check model name: Use GET /v1/models to see the list of currently available models.
4. Check quota: View current window quota usage on the Usage page in the console.
5. Review request logs: Check detailed API request records on the Logs page in the console.