API docs

POST https://staging-j97-api-9tm2.encr.app/v1/systemone

Base URL: https://staging-j97-api-9tm2.encr.app

No key? POST /demo/systemone takes the same body with no auth and no charge, limited to 10 requests per minute per IP and 2,000 input tokens.

Authorization: Bearer tia_live_<32 url-safe characters>

Send your API key in the Authorization header. Keys look like tia_live_ followed by 32 characters, are created in your account and shown once. Only a SHA-256 hash is stored; if you lose a key, revoke it and create a new one.

The body is a JSON object:

{
  "state": {
    "kenh": "zalo",
    "goi_dich_vu": "Pro năm",
    "tin_nhan": "Chào shop, tháng này em bị trừ tiền 2 lần cho gói Pro, 499.000đ mỗi lần, hoá đơn thứ hai vẫn đang treo. Nhờ shop hoàn lại khoản bị trừ trùng trong hôm nay giúp em, mai kế toán bên em chốt sổ rồi."
  },
  "questions": {
    "hoan_tien": {
      "type": "noul",
      "instructions": "Khách có đang yêu cầu trả lại tiền không?",
      "criteria": {
        "true": "đòi hoàn tiền, huỷ giao dịch hoặc bù tiền",
        "false": "không đòi lại tiền"
      }
    },
    "doi_xu_ly": {
      "type": "choice",
      "instructions": "Đội nào nên nhận ticket này?",
      "criteria": {
        "thanh_toan": "hoá đơn, trừ tiền, hoàn tiền, gói cước",
        "ky_thuat": "lỗi, sự cố, tích hợp",
        "tai_khoan": "đăng nhập, quyền truy cập, bảo mật",
        "ban_hang": "mua mới, nâng cấp, báo giá"
      }
    },
    "muc_do_gap": {
      "type": "score",
      "instructions": "Ticket này gấp đến mức nào?",
      "criteria": [
        "để tuần sau được",
        "bình thường, trả lời trong 2 ngày",
        "ảnh hưởng tiền hoặc công việc hôm nay",
        "sự cố diện rộng, rủi ro pháp lý hoặc bảo mật"
      ]
    }
  }
}

Every question needs instructions: a string stating the question.

A 200 response has this shape (TypeScript types):

type Response = {
  id: string;                    // "req_…", quote it for support
  object: "systemone";
  model: string;
  answers: Record<string,        // one entry per question name
    | { type: "noul"; noul: number }                      // P(yes), 0..1
    | { type: "choice"; choice: string; confidence: number;
        probabilities: Record<string, number> }           // sums to 1
    | { type: "score"; score: number; confidence: number; // score = expected level
        legend: Record<string, string>;                   // "0" → lowest description
        probabilities: Record<string, number> }
  >;
  cached: boolean;               // served from a stored result: cached price
  usage: { input_tokens: number; output_tokens: 0;
           cached_input_tokens: number; // input_tokens if cached, else 0
           free_tokens: number;         // free quota used (1/10 per cached token)
           cost_micro_vnd: number; cost_display: string };
  balance_display: string;       // e.g. "12.345 đ"; absent on /demo/systemone
};

Every error looks like {"code": ..., "message": ..., "details": ...}. message is for humans, code is for branching. Model 400s carry details.type = input_too_long or invalid_request.

• Every month (Vietnam time) includes 100,000,000 free input tokens, spent first; after that 500 đ per 1M input tokens from your wallet. Output is free. Prices apply from 1 October 2026.
• A repeated request answered from a stored result ("cached": true; same account, same JSON content, same model revision) costs 50 đ per 1M tokens and uses 1/10 of the free tokens; usage.cached_input_tokens counts the tokens billed at that price.
• Input tokens are the state, instructions and criteria descriptions. usage.input_tokens and usage.cost_display in the response belong to that request.
• Request limits apply per account (all its keys share them) and rise with the tier. The tier is your lifetime total of completed top-ups.
• Every response carries an id (req_…). Quote it when asking for support.

The Free tier is also capped per IP: every free account on one IP shares one daily quota (window ip_day).

Every tier has the same input limit: 4,096 tokens per request, which is the model’s own hard limit. GET /v1/models reports it as max_input_tokens. Over the limit, the response is 400 with details.type input_too_long.

A 429 response carries these headers (use them to pace your calls):

A 429 body names the window that was hit (minute, hour, day, concurrency, ip_day):

{
  "code": "rate_limited",
  "message": "rate limit exceeded",
  "window": "minute",
  "limit": 30,
  "retry_after_seconds": 2,
  "tier": "free",
  "upgrade_url": "https://tia.8syncdev.com/pricing"
}

The examples read the base URL and key from environment variables; never put a key in code.

export TIA_API_URL="https://staging-j97-api-9tm2.encr.app"
export TIA_API_KEY="tia_live_..."

curl -sS "$TIA_API_URL/v1/systemone" \
  -H "Authorization: Bearer $TIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":{"kenh":"zalo","goi_dich_vu":"Pro năm","tin_nhan":"Chào shop, tháng này em bị trừ tiền 2 lần cho gói Pro, 499.000đ mỗi lần, hoá đơn thứ hai vẫn đang treo. Nhờ shop hoàn lại khoản bị trừ trùng trong hôm nay giúp em, mai kế toán bên em chốt sổ rồi."},"questions":{"hoan_tien":{"type":"noul","instructions":"Khách có đang yêu cầu trả lại tiền không?","criteria":{"true":"đòi hoàn tiền, huỷ giao dịch hoặc bù tiền","false":"không đòi lại tiền"}},"doi_xu_ly":{"type":"choice","instructions":"Đội nào nên nhận ticket này?","criteria":{"thanh_toan":"hoá đơn, trừ tiền, hoàn tiền, gói cước","ky_thuat":"lỗi, sự cố, tích hợp","tai_khoan":"đăng nhập, quyền truy cập, bảo mật","ban_hang":"mua mới, nâng cấp, báo giá"}},"muc_do_gap":{"type":"score","instructions":"Ticket này gấp đến mức nào?","criteria":["để tuần sau được","bình thường, trả lời trong 2 ngày","ảnh hưởng tiền hoặc công việc hôm nay","sự cố diện rộng, rủi ro pháp lý hoặc bảo mật"]}}}'

import os, time
import requests  # pip install requests

BASE = os.environ["TIA_API_URL"]
KEY = os.environ["TIA_API_KEY"]

body = {
    "state": "Em bị trừ tiền 2 lần cho gói Pro tháng này, nhờ shop hoàn lại giúp em.",
    "questions": {
        "hoan_tien": {"type": "noul", "instructions": "Khách có yêu cầu trả lại tiền không?"},
        "muc_do_gap": {
            "type": "score",
            "instructions": "Ticket này gấp đến mức nào?",
            "criteria": ["để tuần sau được", "bình thường", "ảnh hưởng tiền hôm nay"],
        },
    },
}

for attempt in range(3):
    r = requests.post(f"{BASE}/v1/systemone", json=body, timeout=30,
                      headers={"Authorization": f"Bearer {KEY}"})
    if r.status_code not in (429, 503):
        break
    time.sleep(float(r.headers.get("Retry-After", "1")))

if r.status_code != 200:
    err = r.json()
    raise SystemExit(f"{r.status_code} {err['code']}: {err['message']}")

data = r.json()
print(data["answers"]["hoan_tien"]["noul"])    # P(có)
print(data["answers"]["muc_do_gap"]["score"])  # mức kỳ vọng, thấp nhất = 0
print(data["usage"]["cost_display"], data["balance_display"])

const BASE = process.env.TIA_API_URL;
const KEY = process.env.TIA_API_KEY;

const res = await fetch(`${BASE}/v1/systemone`, {
  method: "POST",
  headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    state: { tieu_de: "Không thanh toán được bằng VietQR", nen_tang: "Android 3.4.1" },
    questions: {
      thanh_phan: {
        type: "choice",
        instructions: "Lỗi nằm ở thành phần nào?",
        criteria: { app_mobile: "ứng dụng Android/iOS", cong_thanh_toan: "cổng thanh toán, VietQR" },
      },
    },
  }),
});

const data = await res.json();
if (!res.ok) {
  // 400 invalid_argument, 401 unauthenticated, 402 payment_required, 429 / 503 (see Retry-After)
  throw new Error(`${res.status} ${data.code}: ${data.message}`);
}
console.log(data.answers.thanh_phan.choice, data.answers.thanh_phan.probabilities);

// npm install @typesafe-ai/sdk
// .env
//   TIA_API_URL=https://staging-j97-api-9tm2.encr.app
//   TIA_API_KEY=tia_live_...
import { TypeSafeClient, choice, noul, score } from "@typesafe-ai/sdk";

process.env.TYPESAFE_BASE_URL = process.env.TIA_API_URL;
process.env.TYPESAFE_API_KEY = process.env.TIA_API_KEY;
const client = new TypeSafeClient();

const { answers } = await client.systemOne({
  state: { tin_nhan: "Em bị trừ tiền 2 lần, nhờ shop hoàn lại giúp em." },
  questions: {
    hoan_tien: noul("Khách có yêu cầu trả lại tiền không?"),
    doi_xu_ly: choice("Đội nào nên nhận ticket?", {
      thanh_toan: "hoá đơn, trừ tiền, hoàn tiền",
      ky_thuat: "lỗi, sự cố",
    }),
    muc_do_gap: score("Gấp đến mức nào?", ["để tuần sau", "bình thường", "trong hôm nay"]),
  },
});

answers.doi_xu_ly.choice; // "thanh_toan" | "ky_thuat"

The example below reads TIA_API_URL and TIA_API_KEY, then passes them through the TYPESAFE_BASE_URL and TYPESAFE_API_KEY configuration variables used by @typesafe-ai/sdk. It sets no model, so the API answers with the currently served build, not experimental candidate TIA 1.5.

TYPESAFE_BASE_URL=https://staging-j97-api-9tm2.encr.app
TYPESAFE_API_KEY=tia_live_...