Skip to main content

HTTP Status Codes

CodeMeaningAction
200SuccessProcess response
400Bad RequestCheck request parameters
401UnauthorizedVerify API key
402Payment RequiredTop up wallet balance
404Not FoundCheck endpoint URL
500Internal ErrorRetry or contact support

Error Response Format

{
  "error": "Insufficient balance: has $0.50, needs $1.00",
  "code": "INSUFFICIENT_BALANCE",
  "details": {
    "currentBalance": 0.50,
    "requiredBalance": 1.00,
    "deficit": 0.50
  }
}

Common Error Codes

  • INVALID_API_KEY - API key is missing or invalid
  • INVALID_MODEL - Unsupported model specified
  • INSUFFICIENT_BALANCE - Not enough USDC in wallet
  • PAYMENT_VERIFICATION_FAILED - Payment signature invalid
  • RATE_LIMIT_EXCEEDED - Too many requests
  • INTERNAL_ERROR - Server error

Example Error Handling

try {
  const result = await chat(prompt);
  console.log(result.text);
} catch (error) {
  if (error.response?.status === 402) {
    console.error('Please top up your wallet');
  } else {
    console.error('Error:', error.message);
  }
}