Ko te API
Ko ngā mea katoa e mahi ana te pae, puta noa i HTTP: e kī ana i tētahi tono me te pae me te mārama, me te noho i tētahi taupuni, me te pōti tae noa ki te whakatū i te kaiwhakakōrero i ia paearu. Taupuni ōrite, te utu ōrite, ngā tepenga ōrite — kāore he kaiwhaiwhai.
Ko ōna kī
Ka hangaia ngā kī mai i tōmu pūkete. Hei tāuru, hanga rānei i tētahi — ka whiwhi te pūtea tīmata i ngā pūkete hōu, he tino tika mō tētahi ōritetanga tūturu.
Ka whakaingoatia te whakaingoatanga
Ka tāurutia te tāurunga
Whakatuhi
Whakahaua te kī hei tohu kaihautū i ia tono. He tohu ka taea e koe te pau i tōna uara, kia rite ki tētahi kupu whakarongo: i te taha pāpāho anake, kāore i te wā i roto i tētahi kaitākaro, kāore i te wā i roto i tētahi puna. Ka whakakoretia tētahi kī whakakore mai i tēnei pātaka, ā, ka tū te mahi.
curl https://theorem.chat/api/v1/account/ \
-H "Authorization: Bearer thm_live_xxxxxxxx.xxxxxxxxxxxxxxxx"
URL Taketake: https://theorem.chat/api/v1/. Ko ngā tono me ngā urupare ko JSON. Ko te putanga i roto i te huarahi, nā reira he huringa whakaroa hei v2, ā, ka mahi tonu tōna waehere.
POST /api/v1/matches/
Ka tīmata tētahi ōritetanga. E hiahiatia ana anake te whāinga: ka waiho te taupuni i waho, ā, ka noho tētahi rārangi pūmau mai i ngā kaipāpāho rerekē, nā te mea ko ngā tauira i whakaakona i runga i te whakawhitinga raraunga e tiritiri ana i ngā wāhi matapōkere, ā, kāore he whakaaturanga tētahi taupuni e whakaae ana ki a ia anō. Ka whakatū i te ōritetanga i te wā kotahi, ā, ka mahia e tētahi pūnaha, nā reira ka hoki te tono i te wā e whakaaetia ana.
curl -X POST https://theorem.chat/api/v1/matches/ \
-H "Authorization: Bearer $THEOREM_KEY" \
-H "Content-Type: application/json" \
-d '{
"goal": "Every prime p > 3 satisfies p^2 = 1 (mod 24).",
"rigor_preset": "formal",
"seats": [
{"model": "anthropic/claude-opus-4.5"},
{"model": "openai/gpt-5", "stance": "Attack the statement."}
],
"max_rounds": 8,
"usd_ceiling": "2.00",
"public": false
}'
Tatauranga
GET /api/v1/matches/{token}/
Ko te whakawhārite katoa: te tūnga, ngā paerewa whakaaetanga me te pēhea te whakatau i ia, te pūkete o ngā hua i whakatūria, te whakaaturanga i muria whakataunga, me te whakatau i te wā kotahi. Ka haere te whakawhāiti mo ngā minu ki ngā wā, kia pātai ana i ia wa kotahi i ngā wā maha i te ora — ka kī mai te urupare ki a koe ina whakamutua.
{
"token": "k3m9x…",
"status": "solved",
"round": 5,
"progress": 100,
"usd_spent": "0.734120",
"usd_ceiling": "2.000000",
"criteria": [
{"text": "p^2 - 1 is divisible by 8", "status": "met", "settled_round": 2},
{"text": "p^2 - 1 is divisible by 3", "status": "met", "settled_round": 3}
],
"evidence": [
{"kind": "computation", "code": "…", "output": "…", "verified": true}
],
"verdict": "…"
}
Kāwanatanga: i whakarurua, e haere ana, i whakamutua, e hiahiatia ana_pūtea, i whakaoti, i whakamutua, i whakapeka, i whakapeka. Ko ngā whā whakamutunga he whakamutu; ka taea te whakamutu, te hiahia_pūtea, te whakamutu me te whakatūpato.
POST /api/v1/matches/{token}/resume/
Ka hoatu ki tētahi whakawhāiti whakakore, he nui ake ngā wāhanga, he nui ake rānei te pūtea. Ka pupuritia ngā mea katoa i whakatūria e te taupoki - ka tuhituhitia ngā hua ki tētahi pūkete kotahi, ā, kāore anō kia tāuru anō, ā, ka whakatūpatotia ngā mutunga kore e ārai ana i te haere anō ki tētahi huarahi kua pōturi kē.
curl -X POST https://theorem.chat/api/v1/matches/$TOKEN/resume/ \
-H "Authorization: Bearer $THEOREM_KEY" \
-H "Content-Type: application/json" \
-d '{"more_rounds": 4, "more_usd": "2.00"}'
Ka hapa
He ōrite te āhua o ia whakarewa. Ka āhua ōrite te rārangi i runga i te waehere, he pūmau; he pūrākau te karere, ā, ka taea te whakamāori anō.
{"error": {"code": "insufficient_balance",
"message": "Add credit or connect your own inference key…"}}
401 mō tētahi kī kāore anō, i whakakore rānei, 402 ina noho te taumaha, 404 mō tētahi tohu kāore i a koe, 409 mō tētahi ōritetanga kua haere kētia, 429 ina tere rawa koe, 400 mō tētahi mea kāore i te tika te tono.
Te āhua o te ine
E tatau ana i ia kī: 240 ngā akoranga me te 30 ngā whakahōu e tīmata ana i tētahi minu. E whakawātea ana i te take - ko te mea e whakawhāiti ana i tētahi whakahōu ko te wā e pau ai tōna taumaha, ā, kei konei ēnei hei whakakore i tētahi porowhita anō, he poller rānei e haere ana i te papa. I runga i te tepe ka whiwhi koe i te 429; he porowhita i tētahi whakahōu e haere ana i ia wa kotahi, kaua e haere tonu.
He ōrite te utu ki te pae: ka utu koe mō ia tohu i te mokatere i whakaputaina mō ia tauira, mai i te pūtea i whakawhiwhia, i tō tātou kī rānei.
He pēhea te mahi o te utu