Talkory API Documentation

Getting started

1. Sign in to app.talkory.ai → Settings → API Keys.
2. Click Create key, give it a name, and (optionally) set a monthly spend cap.
3. Copy the key that starts with tk_live_. It is shown only once — store it somewhere safe. If you lose it, revoke it and create a new one.
4. Send it as a Bearer token on every request (see below).

Authentication

Every request must include an Authorization header with your secret key:

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate limits

Each key is limited to 30 requests per minute by default. Requests that exceed the limit receive a 429 response with a Retry-After header (seconds to wait). Responses also include X-RateLimit-Limit and X-RateLimit-Remaining.

Errors

All errors return a consistent JSON shape:

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Slow down and retry.",
    "status": 429,
    "requestId": "req_a1b2c3d4"
  }
}

Include the requestId when contacting support. Possible codes:

Endpoint reference

curl https://api.talkory.ai/v1/health/llm \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch("https://api.talkory.ai/v1/health/llm", {
  headers: { Authorization: `Bearer ${process.env.TALKORY_API_KEY}` },
});
const data = await res.json();
console.log(data.status, data.providers);

import os, requests

res = requests.get(
    "https://api.talkory.ai/v1/health/llm",
    headers={"Authorization": f"Bearer {os.environ['TALKORY_API_KEY']}"},
)
print(res.json())

{
  "status": "ok",
  "checkedAt": "2026-06-27T10:00:00.000Z",
  "providers": {
    "gpt":        { "status": "ok" },
    "claude":     { "status": "ok" },
    "gemini":     { "status": "ok" },
    "grok":       { "status": "error" },
    "perplexity": { "status": "ok" }
  }
}

FAQ

Need a key? Head to your API settings.