Quickstart - Tokz Labs

1. Get a key

Sign in at app.tokz.dev and create a key under API keys. Every account starts with $5 of credit, no card needed.

export TOKZ_API_KEY=tokz_live_...

2. Install

npm install @tokz/sdk

pip install tokz

3. Ask a question

import { Tokz } from "@tokz/sdk";

const tokz = new Tokz({ apiKey: process.env.TOKZ_API_KEY! });

const out = await tokz.decide({
  inputs: "I was charged twice and the app keeps logging me out.",
  decisions: {
    queue: { type: "choice", options: ["billing", "technical", "account"] },
    urgent: { type: "bool" },
  },
});

const r = out.results[0]!;
console.log(r.queue.best, r.queue.policy, r.urgent.best);

import os
from tokz import Tokz

tokz = Tokz(api_key=os.environ["TOKZ_API_KEY"])

out = tokz.decide(
    "I was charged twice and the app keeps logging me out.",
    {
        "queue": {"type": "choice", "options": ["billing", "technical", "account"]},
        "urgent": {"type": "bool"},
    },
)
r = out["results"][0]
print(r["queue"]["best"], r["queue"]["policy"], r["urgent"]["best"])

best is the answer, policy the probability of every option. Send up to 64 texts in one call: every request bills at least 256 tokens.

Next

Decisions API

All four question types, models and limits.

Billing

What a billed token is, and what happens at $0.

Troubleshooting

Errors and what to do about each.