Authentication

Bearer Token

HiPix uses Bearer token authentication. Every request must include your API key:

Authorization: Bearer sk-your-api-key

Missing or Invalid Key

If the key is missing or invalid, you’ll receive a 401 Unauthorized response:

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Insufficient Balance

If your account doesn’t have enough balance for the requested operation:

{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  }
}

To resolve, top up your balance in the dashboard under Wallet.

Rate Limiting

Requests are rate-limited per token group. If you exceed the limit:

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

Check the X-RateLimit-Remaining header in responses to monitor your usage.