AI enhancement

AI is only exposed when it is useful.

BoringKit is utility-first. AI is hidden from normal tool cards unless a supported paid-plan flow has a concrete action, meaningful output, privacy copy, timeout/error handling, and live provider proof.

Who can use it

Plus

Not eligible for AI. Plus stays focused on non-AI daily tools, larger files, saved jobs, and personal API usage.

Pro

Eligible for supported AI actions, batch work, API jobs, and webhook workflows.

Business

Eligible for supported team workflows when AI is enabled for that environment.

Custom

Available by agreement for negotiated usage, privacy, routing, or support requirements.

Free

Standard utility processing remains available by tool limit; AI actions require Pro or higher.

Request shape

This endpoint is a guarded contract for supported account flows. It should not be presented as a generic feature on every tool.

Example

POST https://api.arconath.com/boringkit/v1/ai/enhance
Content-Type: application/json
Authorization: Bearer bk_... # optional for server-side API use; needs ai:write

{
  "toolSlug": "case-converter",
  "input": "make this clearer for a customer email",
  "instruction": "Improve clarity and keep the meaning",
  "tone": "professional",
  "language": "same as input"
}

AI enhancement uses the signed-in account or scoped API key owner plan and the same monthly credit balance. Server-side API calls must use an active key with ai:write. Text enhancement is metered at 8 credits plus 1 credit per 1,000 input characters. Document or worker-backed enhancement is metered at 12 credits plus 1 credit per 1,000 input characters. Validation failures cost 0 credits; provider failures are refunded.

Response shape

Example

{
  "toolSlug": "case-converter",
  "planId": "pro",
  "model": "configured-model",
  "output": "A clearer version of the submitted text.",
  "inputCharacters": 43,
  "costUnits": 9,
  "cost": { "amount": -9, "reason": "ai_enhance_accepted" },
  "credits": { "planId": "pro", "remainingCredits": 9991 }
}

Errors

auth_required

scope_required

The API key is active but does not include ai:write.

plan_upgrade_required

Upgrade to Pro or higher. The response includes the current plan and allowed plans.

invalid_ai_payload

Send valid JSON with a tool slug and input text.

invalid_ai_input

Provide both toolSlug and input.

ai_unavailable

AI enhancement is temporarily unavailable for the environment. Retry later or continue without enhancement.

Visibility gate

A public tool may show AI only after it defines the exact action, the before/after behavior, the output validation, the plan gate, and the privacy expectation. Generic badges such as “AI assist” are intentionally removed from tools that do not meet this bar.

Pages

Tool Kits