Features
Usage and Billing
Lezu measures translation work in translation units.
Free To Organize
- Projects
- Keys
- Locales
- Environments
What Produces Usage
Translation usage is calculated as:
source characters * target languages = translation units
Example:
2,000 source characters * 3 target languages = 6,000 translation units
Estimate Before Translating
POST /v1/translate/estimate
Authorization: ApiKey lez_...
Content-Type: application/json
{
"sourceLocale": "en",
"targetLocales": ["nl", "fr", "de"],
"items": [
{
"id": "home.title",
"text": "Welcome back"
}
]
}
Read Usage and Credits
GET /v1/usage
GET /v1/billing
GET /v1/billing/credits
Billing summaries show the free baseline account state, purchased credits, monthly credit subscription options, usage caps, and usage information for the current account. Lezu does not sell project, key, locale, or environment tiers. Paid usage is added through one-time credit packs or monthly credit subscriptions.
The dashboard usage page visualizes the same server-side usage records by daily translation units, operation/action amount, and recent immutable actions. The displayed amount is translation units, which maps directly to consumed credits.
Usage Caps
Lezu caps infrastructure-heavy work separately from credits:
- API requests
- concurrent import, export, release, and translation jobs
- import file size
- stored import/export/release artifacts
- auth and notification emails
- queue priority
Credits gate AI translation. Usage caps gate infrastructure and abuse.
Buy Credits
Lezu creates PayPal checkout orders for credit packs. After the buyer approves the order in PayPal, the dashboard or client captures the order through Lezu so the API can verify the completed payment and add credits to the account.
Monthly credit subscriptions should use PayPal recurring subscriptions when implemented. They grant credits every billing cycle and can use a lower per-credit price than one-time packs.
POST /v1/billing/checkout-sessions
Authorization: ApiKey lez_...
Content-Type: application/json
{
"creditPackId": "credits_100k",
"successUrl": "https://dashboard.lezu.app/billing/success",
"cancelUrl": "https://dashboard.lezu.app/billing"
}
The response includes a PayPal approval URL:
{
"id": "paypal_order_id",
"status": "created",
"url": "https://www.paypal.com/checkoutnow?token=...",
"provider": "paypal",
"creditPackId": "credits_100k"
}
Capture the approved order:
POST /v1/billing/checkout-sessions/:orderId/capture
Authorization: ApiKey lez_...
Captured purchases appear in the billing ledger as credit_purchase rows and increase purchasedCredits, totalCredits, and remainingCredits.
Relevant Endpoints
| Method | Endpoint | Scope |
|---|---|---|
GET |
/v1/usage |
usage:read |
GET |
/v1/billing |
usage:read |
GET |
/v1/billing/credits |
usage:read |
POST |
/v1/billing/checkout-sessions |
usage:read |
POST |
/v1/billing/checkout-sessions/:orderId/capture |
usage:read |
POST |
/v1/translate/estimate |
translate:read |