Common Exceptions

Insufficient Account Balance

{
    "status": 400,
    "type": "/exception/client_error/not_enough_balance",
    "title": "not_enough_balance",
    "detail": "Your account does not have sufficient balance to process API requests."
}

Possible Causes:

• There might be pending payments or an insufficient balance in your account.
• The subscription payment was unsuccessful.
• The payment for usage beyond your plan's limits (overage) was unsuccessful.
• The credits available under the free plan have been exhausted.

Solution:

• Please log in to your account and navigate to the billing page.
• Address the issue identified and attempt to use the API once more.

---

Overage Payment Failed

{
    "status": 400,
    "type": "/exception/client_error/overage_payment_failed",
    "title": "overage_payment_failed",
    "detail": "You have an unpaid balance. Please log in to your account to complete the payment."
}

Possible Causes:

• A previous attempt to pay for usage beyond your plan's limits (overage) was unsuccessful.
• Your current subscription plan has expired.

Solution:

• Log in to your crop.photo account.-
• Update your credit card information if necessary.
• Consider subscribing to a new plan if your current subscription has expired.
• If a previous overage payment was unsuccessful, please click on the "Pay now" button to settle the outstanding balance.

:::tip
Note: After updating your billing information or making a payment, it may take a few minutes for the changes to reflect in your account.
:::

---

Unable to find matching target resource method

{
    "status": 404,
    "type": "/exception/client_error/not_found",
    "title": "Unable to find matching target resource method",
    "detail": "Unable to find matching target resource method"
}

Possible Causes:

• The specified endpoint does not match any available in the API.
• The URL might have been mistyped or does not correspond to any existing API paths.
• Special characters that are not properly encoded can cause the server to fail in interpreting the URL correctly.
• The method (GET, POST, PUT, DELETE, etc.) used in the request does not match what the API endpoint expects.

Solution:

• Ensure that the URL you're trying to access is correct. Compare it carefully with the documentation provided for the API to confirm it matches exactly. Pay special attention to potential typographical errors.
• Sometimes, an unintended space at the end or within the URL can cause the request to fail. Ensure there are no extra spaces in your URL.
• Review the URL for any special characters. If present, ensure they are correctly encoded. For example, spaces should be encoded as %20, and the ampersand & should be encoded as %26.
• Make sure that the HTTP method you are using (e.g., GET, POST) is the one expected by the API for the endpoint you're trying to reach. Consult the API documentation for guidance on which method to use for each endpoint.

---

Missing AI Model

{
    "status": 400,
    "type": "/exception/client_error/missing_ai_model",
    "title": "missing_ai_model",
    "detail": "Missing AI model. Please note that analysis hints are only applicable with a designated AI model. For further assistance, refer to the documentation."
}

Possible Causes:

• This exception happens when the ai_model property is missing and analysis_hint is provided.

Solution:

• Add ai_model property to your payload.

---

No Active Subscription

{
  "status": 400,
  "type": "/exception/client_error/no_active_subscription",
  "title": "no_active_subscription",
  "detail": "No active subscription on this account. Please check your account details and make sure you have an active ongoing subscription.",
  "extensions": {
    "tenant_id": "Your tenant id"
  }
}

Possible Causes:

• Your existing subscription has expired.
• Payment for the existing subscription has failed.

Solution:

• Visit Crop.photo Billing Page and active your subscription.
• Otherwise contact our support to resolve your issue.

---

Invalid Input URL

{
  "status": 500,
  "type": "/exception/server_error/internal_server_error",
  "title": "java.io.IOException: Server returned HTTP response code: 403 for URL: https://mycompany.com/my/image.jpeg"
}

Possible Causes:

• Given input URL in the image is not accessible.
• Given input URL is expired or requires authentication.

Solution:

• Make sure the given input URL is accessible on the internet as it is, without any modification or authentication.

---

:::info
If you require further assistance or have any questions, please do not hesitate to contact our customer support team.
:::