AI API AggregatorDocumentation

Errors

docs.errorsBody

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Wallet balance is below required amount.",
    "details": { "requiredCents": 1500, "availableCents": 800 },
    "request_id": "req_..."
  }
}

Authentication

CodeMeaning
invalid_api_keyAPI key is invalid or revoked.
user_blockedUser account is suspended.
email_not_verifiedEmail is not verified yet.

Billing

CodeMeaning
insufficient_balanceWallet balance is below the required amount.
price_not_configuredNo price is configured for this method/bundle.
provider_rate_card_not_configuredProvider rate card is missing.

Catalog

CodeMeaning
unsupported_providerProvider is not supported.
unsupported_modelModel is not supported.
unsupported_methodMethod is not supported.
method_not_available_for_userThis method is not enabled for your account.
provider_unavailableProvider is temporarily unavailable.
model_unavailableModel is temporarily unavailable.
method_unavailableMethod is temporarily unavailable.

Tasks

CodeMeaning
task_not_foundTask does not exist.
task_not_ownedYou do not own this task.
task_expiredTask has expired.
task_failedTask failed.
task_timed_outTask timed out.

Request

CodeMeaning
invalid_requestThe request is malformed.
invalid_parametersSome parameters did not pass validation.
rate_limit_exceededYou hit the rate limit. Slow down and retry.
idempotency_key_in_useIdempotency key is currently being processed.
idempotency_key_mismatchIdempotency key was reused with a different payload.

Coupons

CodeMeaning
coupon_invalidCoupon code is invalid.
coupon_expiredCoupon is expired.
coupon_already_usedCoupon was already redeemed.

Generic

CodeMeaning
internal_errorUnexpected internal error. Try again later.