Skip to content
CloakAPI docs

Quickstart (5 min)

You’ll need an API key. Sign up at app.cloakapi.io and create a key under Integration → API keys. Free tier includes 1M gateway tokens per month.

1. Install the SDK

Use any standard OpenAI or Anthropic client — only the base URL changes.

Terminal window
pip install openai
# or
npm install openai

2. Point it at the gateway

from openai import OpenAI


client = OpenAI(
    base_url="https://api.cloakapi.io/api/v1",
    api_key="ck_live_…",
)


resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Summarise the attached email"}],
)
print(resp.choices[0].message.content)

3. Verify the receipt

Every response includes an X-CloakAPI-Receipt header containing a JSON-encoded OpenReceipt envelope. To verify it without an account:

Terminal window
curl -X POST https://api.cloakapi.io/api/v1/receipts/verify \
  -H 'Content-Type: application/json' \
  -d '{"receipt": <paste the envelope here>}'

Or paste it into the browser-based verifier at app.cloakapi.io/receipt-verifier.

A valid: true response means:

  • the schema is intact,
  • the signature was made by a key listed in the public JWKS,
  • the chain prev_hash links into the previous receipt for the same tenant.

That’s it — you’re now sending traffic through a gateway that produces audit-grade evidence on every call.