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.)