Request & Response Format

Request Format

All requests use JSON format and require the following headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Response structures vary by endpoint, but each follows its respective API specification:

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request",
    "message": "Specific error description"
  }
}

Status Code	Description	How to Handle
400	Invalid request parameters	Check request parameter format
401	Authentication failed	Verify your API key is correct
402	Insufficient balance	Top up your account
429	Rate limit exceeded	Reduce request frequency
500	Internal server error	Retry later