Skip to main content

Credits

The APIs operate on a credit-based system for pricing and usage. Credits serve as a currency to account for the resources consumed by each API call. This section provides an overview of how credits work and how you can manage them effectively.

Credit Consumption​

The usage of credits depends on the type of API call made:

  • Preview Generation: Each preview generation request consumes 0.25 credits.

  • Full Version Generation: Generating a full version of a product image requires 1 credit.

In case the requests error out or even take unusually long, your credits will be returned back to you. Below are the time limits that we've set for ourselves:

  • Preview: 10 seconds
  • Generation: 25 seconds

Please note

  • the reversals happen asynchronously. You can invoke the GET /v1/credits API documented below to verify.
  • the time limits don't reflect our averages. Reaching these should be unusual.

The image upload and suggestion APIs are free to use.

Managing Credits​

To access and utilize the BlendIt Studios' Enterprise APIs, you can pre-purchase credits against your API key. This approach allows you to have a clear understanding of the available credits and ensures seamless usage without interruptions. Alternatively, you may discuss a flexible agreement for post-payment with our team, tailored to your specific needs.

Monitoring Credit Balance​

To keep track of your credit balance and usage, watch the X-Credits-Remaining header in the API responses. It will provide information about the remaining credits after an API call is made. This allows you to proactively monitor and manage your credit consumption effectively.

You can also make a GET request to the below endpoint to know your current balance at any time:

https://daas.blend-api.com/v1/credits

Example:

curl --location 'https://daas.blend-api.com/v1/credits' --header 'X-API-Key: YOUR_API_KEY'

Navigate here for the detailed API spec.

Replenishing Credits​

When your credit balance is running low, you need to replenish your credits to continue using the APIs without interruption. Depending on your pre-purchase agreement or the agreed-upon payment terms, you can follow the outlined procedures to add more credits to your account.

For any questions, concerns, or assistance regarding credits, API usage, or billing, please reach out to our support team. We'll be more than happy to help you make the most of Blend's DaaS APIs.