fashn-logo
FASHNAI

Credits Balance

The Credits endpoint allows you to retrieve your current FASHN API credits balance. The response includes your total credits, API subscription credits (if you have an active subscription), and any additional on-demand credits you've purchased.

Credit Usage
  • Subscription Credits: Included with your monthly API plan
  • On-Demand Credits: Additional credits purchased separately
  • Total Credits: Combined balance of subscription + on-demand credits

Request

Check your current credits balance by making a GET request to the credits endpoint:

GEThttps://api.fashn.ai/v1/credits

Call this endpoint whenever you need to know how many credits you have remaining.

Request Examples

curl -X GET https://api.fashn.ai/v1/credits \
     -H "Authorization: Bearer YOUR_API_KEY"

Response

Example response payload

{
  "credits": {
    "total": 234,
    "subscription": 100,
    "on_demand": 134
  }
}

Response Fields

creditsobject

Container object for all credit information.

totalinteger

Your total available credits (subscription + on-demand credits combined).

subscriptioninteger

Credits included with your current API subscription plan. These credits reset monthly based on your billing cycle.

on_demandinteger

Additional credits purchased separately from your subscription. These credits are consumed after subscription credits.

Rate Limits

The credits endpoint has its own specific rate limit:

EndpointLimit
/v1/credits30 requests per 10 seconds

For other endpoints, see the default rate limits in API Fundamentals.

Previous

Background Remove

Next

Try-On Parameters

On this page

RequestRequest ExamplesResponseResponse FieldsRate Limits