Errors And Credits

Error payloads, credits, and request limits for the external API.

Error Shape

{
  "error": {
    "message": "Model is not available",
    "type": "model_not_available",
    "code": "model_not_available"
  }
}

Common Error Codes

  • invalid_api_key
  • scope_not_allowed
  • rate_limit_exceeded
  • api_disabled
  • model_required
  • model_not_available
  • messages_required
  • prompt_required
  • insufficient_credits
  • provider_not_configured
  • provider_error

Credits

  • Chat and image requests consume platform credits.
  • Credit cost is configured per model in the platform model registry.
  • If credits are insufficient, the request is rejected before execution.

Rate Limits

  • Each API key can define a requests-per-minute limit.
  • If an API key has no explicit limit, the platform default rate limit is used.