Guides de la plateforme

Errors and rate limits

Troubleshoot failures using status codes and request context.

Common status codes

StatusAction
401Check that the key is complete, enabled, and not expired.
403Check model, group, or IP restrictions.
404Check the base URL, path, and model name.
429Reduce concurrency and retry with backoff.
5xxRecord request details and retry. Submit a ticket if failures persist.

Rate limits

Exact limits depend on the account, model, group, and upstream channel. Do not assume fixed RPM or TPM. Use the response, current policy, and Console logs.

Retry strategy

  1. Use exponential backoff only for retryable 429 and temporary 5xx responses.

  2. Set a retry limit and retain request correlation details.

  3. Do not automatically retry authentication, permission, or invalid-parameter errors.