Usage and billing

CKEditor AI counts the credits your requests consume and attributes each request to a user. Read those numbers from your backend for any period: the total for the environment, and the credits per user. This page covers the request, the response, and what happens when the allowance runs out.

• Find the heavy users: get the credits per user for any period, then group them into your own teams or workspaces.
• Stay inside your allowance: read the usage on a schedule, and act before the environment reaches its plan limit.
• Show usage in your product: give admins in your app a view of their team’s AI usage without exporting anything.
• Bill each tenant: if you resell AI features, meter the usage per tenant or per seat.

CKEditor AI measures usage in credits. Every billable request consumes credits from the allowance of your environment: a chat message, an action, a review, or a document processing call. The service attributes each request to the user ID in the sub claim of the token that sent the request. Your plan sets the size of the allowance.

Send a POST request to /v1/admin/billing/usage with a token that has the ai:admin permission (see Who can call it). The body takes these fields:

The simplest request returns the environment total:

curl -s "https://ai.cke-cs.com/v1/admin/billing/usage" \
	-H "Authorization: Bearer $ADMIN_TOKEN" \
	-H "Content-Type: application/json" \
	-d '{
		"from": "2026-06-01T00:00:00Z",
		"to": "2026-06-30T23:59:59Z"
	}'

{
	"environment": {
		"id": "df5ghywes2e1r3hy7v4p",
		"credits": 9650
	},
	"users": []
}

To get the credits for specific users, send an array of their user IDs:

curl -s "https://ai.cke-cs.com/v1/admin/billing/usage" \
	-H "Authorization: Bearer $ADMIN_TOKEN" \
	-H "Content-Type: application/json" \
	-d '{
		"from": "2026-06-01T00:00:00Z",
		"to": "2026-06-30T23:59:59Z",
		"users": [ "user_123", "user_456" ]
	}'

Send the string "*" to get every user with activity in the period:

curl -s "https://ai.cke-cs.com/v1/admin/billing/usage" \
	-H "Authorization: Bearer $ADMIN_TOKEN" \
	-H "Content-Type: application/json" \
	-d '{
		"from": "2026-06-01T00:00:00Z",
		"to": "2026-06-30T23:59:59Z",
		"users": "*"
	}'

{
	"environment": {
		"id": "env-id-00000000",
		"credits": 9650
	},
	"users": [
		{ "userId": "user_123", "credits": 8500 },
		{ "userId": "user_456", "credits": 1150 }
	]
}

The response does not list users with no activity in the period. The user IDs are the IDs your token endpoint issues, so you can join the response to your own accounts, tenants, or teams.

The request needs a token with the ai:admin permission. That permission grants full administrative access to your environment. Call this endpoint from your backend only, and never issue an admin token to a browser or to an end user. See Permissions for the other scopes.

On the free plan, CKEditor AI blocks the environment when it exceeds its limit for the billing period, and rejects each request with this error:

{
	"message": "Usage limits exceeded",
	"code": "usage-limits-exceeded",
	"explanation": "The environment is blocked because usage for the current billing period has exceeded the limit.",
	"action": "Please contact our customer support team or upgrade your plan.",
	"data": {
		"environmentId": "env-id-00000000",
		"usageExceededTo": "2025-12-19T12:00:00.000Z"
	}
}

The service rejects requests until the time in data.usageExceededTo, then accepts them again. To remove the block earlier, upgrade the plan.

On paid plans, CKEditor AI bills the extra usage as overage, and the AI features keep responding.

• Permissions lists the scopes you can put in a token, including ai:admin.
• Authentication shows how to build the token endpoint that sets the sub claim.
• REST API links the API reference and lists the rate limits.