Error Handling

API error codes and responses

Response Structure

All API responses follow this structure:

{
  "code": 0,
  "msg": "Success",
  "data": {...}
}

• code: 0 = Success
• code > 0 = Error

---

Error Codes

Code	Message	Description
0	Success	Request completed successfully
429	Rate limit exceeded	Too many POST requests (20/minute limit)
10104	Record not found	Resource ID does not exist
10105	Invalid API key	Wrong or missing x-api-key header
18020	Insufficient credit	Not enough credits to complete request
18025	No permission to call APIs	Account lacks API access permission
40000	Parameter error	Invalid or missing required parameters
50000	System error	Internal server error

---

Error Response Examples

Authentication Error

{
  "code": 10105,
  "msg": "Invalid API key",
  "data": null
}

Insufficient Credits

{
  "code": 18020,
  "msg": "Insufficient credit",
  "data": null
}

Parameter Error

{
  "code": 40000,
  "msg": "Parameter error: avatar_id is required",
  "data": null
}

Rate Limit Error

{
  "code": 429,
  "msg": "Rate limit exceeded. Please try again later.",
  "data": null
}

---

Best Practices

Check Response Code

Always verify the code field before processing data

Handle Errors

Implement proper error handling for all error codes

Log Errors

Record error details with timestamps for debugging

Retry Logic

Implement retry for system errors (50000) and rate limits (429)

---

Need Help?

Contact [e-mail] with:

• Error code and message
• Request parameters
• Timestamp
• API endpoint

Include your user ID (not your API key) when contacting support.