Won

Won 은 기억을 읽는 쪽을 위한 것입니다.

이 API 의 대부분은 기억으로 답합니다. Won 은 기억에 대해 답합니다. 한 저장소가 얼마나 고쳐졌는지, 어디까지 믿어도 되는지입니다. 읽기 전용이고, 무료이며, 검색과 분리되어 있습니다.

Wontopos 는 Won + Topos 이고, 기억이 머무는 하나의 자리라는 뜻입니다. Won 은 그 자리 가운데 기억을 돌려주는 대신 기억에 대해 알려주는 쪽입니다. 이 호출들은 값이 없고, 읽기만 하며, 검색에 손대지 않습니다. 물어도 사용자가 더 내는 것은 없고, 저장된 기억이 달라지지도 않습니다.

지금 올라와 있는 것

지금은 호출 하나입니다.

호출하는 일
POST /won/revisions이 저장소가 쓰인 뒤로 얼마나 고쳐졌는지. 숫자 둘과 그것을 설명하는 문장 둘.

예시 하나

낱개 수가 아니라 비율을 쓰십시오. 40 중 3 과 40 중 30 은 다르게 다뤄야 합니다.

r = mem.revisions()
# {"revised": 3, "total": 40, "counts": "…", "excludes": "…"}

if r["revised"] / r["total"] > 0.1:
    system += "Some of what you remember here has been corrected since."
const r = await mem.revisions();
// { revised: 3, total: 40, counts: "…", excludes: "…" }

if (r.revised / r.total > 0.1) {
  system += "Some of what you remember here has been corrected since.";
}
let r = mem.revisions(None).await?;
let (rev, tot) = (r["revised"].as_f64().unwrap_or(0.0),
                r["total"].as_f64().unwrap_or(1.0));
if rev / tot > 0.1 { /* say so in the system prompt */ }
curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" -H "Content-Type: application/json" \
  -d '{"user_id":"alice"}'

# → {"user_id":"alice","revised":3,"total":40,
#     "counts":"memories a transform has touched (supersede, update, retract, image removed)",
#     "excludes":"deletions — a deleted memory leaves nothing to count"}

counts 와 excludes 는 플래그가 아니라 문장으로 돌아옵니다. 호출자가 대개 모델이기 때문입니다. 삭제는 세지 않습니다.

값과 한도

항목값
요금없습니다. 무료 호출은 과금 관문을 건너뜁니다. 토큰 요금도, 요청당 요금도 없고, 사용량에도 안 잡힙니다.
분당계정마다, 그리고 엔드포인트마다 분당 10회. 한 엔드포인트의 분을 다 써도 다른 엔드포인트의 분은 안 줄어듭니다.
시간당계정당 시간당 300회이고, 무료 호출 전부가 하나를 나눠 씁니다. 이쪽은 경로를 안 보므로, 무료 엔드포인트가 늘어도 계정 하나가 쓸 수 있는 총량은 안 늘어납니다.
유료 트래픽과의 관계양방향으로 분리돼 있습니다. 이 호출이 검색을 느리게 만들지 않고, 검색이 이 몫을 마르게 하지도 않습니다. 한 계정의 키들은 버킷을 공유하므로 키를 늘려도 한도가 늘지 않습니다.

두 천장 모두 429 로 답하며, Retry-After 에 초 단위 시간이, 메시지에 어느 쪽에 걸렸는지가 들어갑니다.

429 rate_limit_error
Retry-After: 41

{ "error": { "type": "rate_limit_error",
    "message": "This endpoint is free and limited to 10 requests per
                minute, counted per endpoint. Retry in 41s." } }
같은 호출이 /api/v1/memory/revisions 에서도 답합니다. Won 이 생기기 전에 배포된 클라이언트를 위한 것입니다. 같은 핸들러이고 같은 예산이며, 두 번째 몫이 아닙니다. 새로 쓰는 코드는 Won 주소를 쓰십시오.