Nuro API Error Handling Guide

Error Categories

1. System Errors

Status	Type	Description
500	api_error	API system error, please contact administrator

2. Authentication Errors

Status	Type	Description
401	unauthorized	Invalid signature
401	unauthorized	Authorization expired
403	forbidden	API usage limit exceeded
403	forbidden	API QPS limit exceeded

3. Content Errors

Status	Type	Description
500	api_error	Algorithm error
404	not_found	Task not found
400	bad_request	Input language not supported
500	api_error	Semantic error, please try again

4. Resource Errors

Status	Type	Description
403	forbidden	Queue is full

Credit Refund Mechanism

Error Types Triggering Refund

api_error

timeout

bad_request

forbidden

Refund Process

Error Detection

Check response status code

Parse error message

Match error type

Refund Conditions

Task not marked as processed

Error type qualifies for refund

User credit deduction record exists

Refund Processing

Update task status

Refund user credits

Log refund transaction

Error Response Format

Best Practices

Always check API response status

Implement error retry mechanism

Maintain detailed error logs

Handle credit refund notifications properly

Provide clear error messages to users

Error handling

Nuro API Error Handling Guide#

Error Categories#

1. System Errors#

2. Authentication Errors#

3. Content Errors#

4. Resource Errors#

Credit Refund Mechanism#

Error Types Triggering Refund#

Refund Process#

Error Response Format#

Best Practices#