Docs

Swap the base URL. Set a cap.

Five minutes. Python shown. Same idea in Node, Go, or anything that speaks OpenAI. Denies are the contract.

1. Create a tab
Console, New tab. Name the agent. Cap in dollars. Window: day is the default.
2. Copy the key
Shown once. Prefix ft_live_. Hash stored. Rotate by issuing a new one.

3. Point the client

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://proxy.flocktab.com/v1",
    api_key=os.environ["FLOCKTAB_KEY"],
    default_headers={
        "x-flocktab-unlock": os.environ["FLOCKTAB_UNLOCK"],
    },
)

4. Handle denials

Body error.code. Header x-flocktab-reason. BLOCKED never reaches the provider.

HTTP	error.code	x-flocktab-reason	When
402	tab_closed	cap.day	Cap or closed tab. Do not retry until it reopens.
402	tool_cap	policy.tool	Named tool hit its cap.
403	risk_blocked	policy.risk	Irreversible. Empty allowlist denies. Remaining floor $25.00.
429	velocity	velocity	Too many calls this minute.
403	model_blocked	policy.models	Model not on the allowlist.
401	key_revoked	-	Unknown or rotated key.
503	ledger_unavailable	ledger	Fail closed. Matching in-flight replay is not a green light.

Do not retry a closed tab until it reopens. 503 is fail closed: do not retry as a green light on a matching in-flight idempotency replay.

Unknown tools are write, not read.

1. Create a tab

2. Copy the key

3. Point the client

4. Handle denials