Skip to content

Billing API

Base path: /api/v1/subscription/

Plans, subscriptions, credit balance, and usage history.

Rate card

What each operation costs is set in one rate card and can change without a release, so read it at runtime instead of hard-coding a price:

curl https://indox.org/api/v1/subscription/rate_card/

No authentication is needed. Only operations currently on sale are listed.

Field Meaning
credits_per_usd Credits per US dollar.
operations[].key convert.document, convert.image, convert.video (video and audio), convert.model, convert.font, office.convert.
operations[].unit per_job: charged once per conversion request, however many output formats it asks for (documents and PDFs, fonts, office files). per_output: charged once per requested output format (images, video and audio, 3D models).
operations[].credits Credits charged per unit.
ai[] AI features: base_credits is charged per use, plus the tokens used at the model's rate. label is the display name.

PDF tools (merge, split, compress and the other PDF operations) are free for signed-in callers and are not on the card.

Every format listing returns the same credits value the job is charged: /api/v1/pdf_handler/formats/ and /operations/, /api/v1/convert/image/formats/, /api/v1/convert/video/formats/, /api/v1/convert/model/operations/, /api/v1/fonts/formats/ and /routes/. GET /pricing_plan/ carries credit_cost and credits_per_usd.

A signed-in request whose balance is below the price is refused with 402 before any work starts. An operation that is not on sale answers 503 {"detail": "subscription.price_unavailable"}, on its listing and on submit.

(Detailed reference TBD, see Concepts → Credits for the basics.)