Quick start

Send a task and structured state. Geltre returns the selected evidence references and usage information.

Request

curl https://api.nicholsai.com/v1/orient \
  -H "Authorization: Bearer $GELTRE_API_KEY" \
  -H "Idempotency-Key: req_123" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Determine whether the target service should restart after failure",
    "state": [
      {"ref":"context:1","source":"context","text":"target service expected mode running; restart policy on failure"},
      {"ref":"context:2","source":"context","text":"target service failed after the latest start attempt"},
      {"ref":"status:1","source":"status","text":"unit status exit code 1"}
    ],
    "budget": 2,
    "target": "decision"
  }'

Response

{
  "evidence": [
    {"ref":"log:2","relevance":0.99},
    {"ref":"log:3","relevance":0.91}
  ],
  "model":"geltre-serviceops-linear-v03",
  "usage":{
    "input_tokens":23,
    "charged_microcents":115
  }
}

Important

• Use a unique Idempotency-Key for each logical request.
• Evidence refs must be unique within the submitted state.
• The initial commercial route supports target="decision".