Machine docs

Jev / System One call docs

The longform column lives at /jev. This page is for programs: auth, request shape, and where the call surfaces must not be mixed. Aijiau POST /v1/systemone is live. api.aijiau.com/jev/docs was a 404; it should 301 here.

Auth

Call the Aijiau gateway with a site identity. Do not send a TypeSafe or other upstream key.

Browser trial: a logged-in session on the console Playground.
Programs: create an sk-... on api.aijiau.com and send Authorization: Bearer sk-....
Do not put an off-site / upstream key on an Aijiau POST.

noul | choice | score

Aijiau's official entry is POST /v1/systemone with model jev, plus state and a questions map. That route is live. Question types match TypeSafe HTTP. The default model id does not.

Aijiau (live): POST https://api.aijiau.com/v1/systemone
model: jev
Live · 0.2.1-aijia.99 · SHA 8ff42e9
TypeSafe (protocol reference): POST https://api.typesafe.ai/v1/systemone
model: jev-latest
Upstream protocol reference

type	Question fields	Answer shape
noul	type + instructions (+ optional true/false criteria)	{ type: "noul", noul }
choice	type + instructions + criteria map (max 255)	{ type: "choice", choice, probabilities, confidence }
score	type + instructions + criteria array (2–10 levels)	{ type: "score", score, legend, probabilities, confidence }

Answer shapes, Choice max 255, and Score 2–10 levels are from the TypeSafe HTTP API (docs.typesafe.ai/api). The Aijiau live curl uses the same type names.

Do not mix the call surfaces

The same decision has at least four doors. Field names differ. Prices differ. One copied line will break the request.

Surface	Entry	Model / key	Noul write	Noul read	Price (own source)
Aijiau HTTP	POST https://api.aijiau.com/v1/systemone (live)	jev	noul	answers.*.noul	¥0.6 / 1M input · output free
TypeSafe HTTP	POST https://api.typesafe.ai/v1/systemone	jev-latest	noul	{ type, noul }	$0.042 / 1M input
Vercel AI SDK	experimental_evaluate	typesafe-ai/jev	boolean	probability	$0.042 / 1M (Gateway cites TypeSafe)
LangChain	TypeSafeClassifier	TYPESAFE_API_KEY	Noul()	response.nouls[id].noul	TypeSafe key / list price

Do not put Vercel's boolean in an Aijiau JSON body. Do not put Aijiau's noul inside experimental_evaluate(). LangChain reads .noul. TypeSafe HTTP defaults to jev-latest; Aijiau's public model id is jev.

Dedicated crawlable page: Do not mix the call surfaces /jev/surfaces

Error codes

These are the HTTP statuses TypeSafe already published. Do not treat them as a complete Aijiau gateway catalog.

HTTP	Name	TypeSafe meaning
401	Unauthorized	Missing or invalid API key. Check the Authorization header.
422	Unprocessable Entity	The request body failed validation — for example a missing required field or a malformed question.
429	Too Many Requests	You have exceeded your rate limit. Back off and retry after a short delay.
529	Overloaded	TypeSafe is temporarily overloaded. Retry after a short delay.

Ops verified on live api.aijiau.com: missing key → 401 (not 404). Valid sk-... with noul / choice / score → 200. POST /v1/chat/completions with model jev returns 400. Do not invent a full 4xx/5xx list here. Retry 429 / 529 with a short delay, as TypeSafe documents.

Billing

Aijiau customer price (live product page, 20 September 2026): ¥0.6 / 1M input tokens, output free. TypeSafe's $0.042 / 1M input is their list price from their docs and homepage — not a speed claim from this site. Do not mash the two into one table. Keys, invoices, and usage live on the api.aijiau.com console.

First call

Open the api.aijiau.com console for an sk-..., then land the curl below. POST /v1/systemone is live. The protocol reference is TypeSafe POST https://api.typesafe.ai/v1/systemone. Do not POST /v1/chat/completions with model jev (400). The numbers illustrate shape, not an SLA. No invented QPS.

curl · POST /v1/systemone · live

# Live Aijiau System One (0.2.1-aijia.99, SHA 8ff42e9)
# POST https://api.aijiau.com/v1/systemone  model: jev
# Protocol reference: POST https://api.typesafe.ai/v1/systemone
# Do not POST https://api.aijiau.com/v1/chat/completions with model jev — that returns 400
# Replace sk-... with a key created under Aijiau API keys
curl -sS -X POST https://api.aijiau.com/v1/systemone \
  -H "Authorization: Bearer sk-your-aijiau-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev",
    "state": "Customer: payment has failed for three days, order ORD-2024-1234, amount $299, needs handling now.",
    "questions": {
      "urgent": {
        "type": "noul",
        "instructions": "Is this issue urgent?"
      },
      "team": {
        "type": "choice",
        "instructions": "Which team should handle it?",
        "criteria": {
          "billing": "Payments, refunds, invoices",
          "technical": "Outages, API errors",
          "sales": "Pricing, new accounts"
        }
      },
      "frustration": {
        "type": "score",
        "instructions": "How frustrated is the customer?",
        "criteria": ["Calm", "Annoyed", "Very angry"]
      }
    }
  }'

Open the console Open Playground Back to the /jev column