FAQ

API Key returns 401 authentication_failed

Possible causes:

  • The API Key is incorrect.
  • The API Key is suspended or deleted.
  • The request does not use Authorization: Bearer {API_KEY}.

Check the token status in Token Management and retry with the cURL example.

Model call returns 403 model_access_denied

Possible causes:

  • The token is not authorized for the model.
  • The user or organization has no access to the model.

Check token model scope and organization model access rules.

Model call returns 503 no_available_channel

Possible causes:

  • The channel is disabled.
  • The channel has not synchronized models.
  • The target model is not enabled.
  • The Route Policy points to an unavailable channel.

Enable the channel, synchronize models, enable the target model, and check the Route Policy.

Model call returns 429

Possible causes:

  • Token quota is exhausted.
  • User or organization budget is exhausted.
  • Rate limit is triggered.

Check Usage Log and Quota Management, then adjust budget or limits if needed.

Streaming requests are slow or interrupted

Possible causes:

  • The upstream model service is slow.
  • The ingress proxy buffers SSE responses.
  • File descriptor limits or database pool capacity is insufficient.

Check /metrics, ingress buffering settings, process open-file limits, and desensitized upstream failure diagnostic files.