Compress a query with one POST.

Call POST /detokenate for the latest API revision, or pin a version with /detokenate/v1. Authenticate with a bearer token. Use application/json with a q field, or text/plain with the raw query as the body (response is plain text only).

Endpoint

POST https://vrbose.ai/detokenate
Authorization: Bearer vb_live_...
Content-Type: application/json

{ "q": "the original query" }

Plain text body

With Content-Type: text/plain, send the raw query as the request body. A successful response is text/plain containing only the compressed query (no JSON, no usage block). Errors still return JSON.

POST https://vrbose.ai/detokenate
Authorization: Bearer vb_live_...
Content-Type: text/plain

the original query

Version-specific URL (same behavior today): POST https://vrbose.ai/detokenate/v1

Response

{
  "q": "compressed query",
  "usage": {
    "original_tokens_estimate": 1200,
    "compressed_tokens_estimate": 650,
    "estimated_savings_percent": 46
  }
}

Limits

Free accounts receive 20 successful API queries per day. Paid accounts are unlimited at $0.01 per successful query and are billed through Stripe when daily usage exceeds 1,000 billable queries. Requests are capped at 64 KB, and past-due paid accounts must update billing before additional API calls succeed.

Machine-readable contract

The OpenAPI spec is available at /openapi.json for client generation, audits, and agent integrations.