{"openapi":"3.1.0","info":{"title":"Tracer model API","version":"2026-11-17","description":"Stateless chat and typed decision inference with workspace billing and model permissions."},"servers":[{"url":"https://app.tracerml.ai/v1"}],"security":[{"BearerKey":[]}],"components":{"securitySchemes":{"BearerKey":{"type":"http","scheme":"bearer","description":"Workspace API key, beginning sb_live_."}},"schemas":{"ChatRequest":{"type":"object","additionalProperties":false,"required":["model","messages"],"properties":{"model":{"type":"string"},"messages":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["role","content"],"properties":{"role":{"enum":["system","developer","user","assistant"]},"content":{"oneOf":[{"type":"string","minLength":1},{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["type","text"],"properties":{"type":{"const":"text"},"text":{"type":"string","minLength":1}}}}]}}}},"max_tokens":{"type":"integer","minimum":1,"maximum":128000,"default":4096},"max_completion_tokens":{"type":"integer","minimum":1,"maximum":128000},"stream":{"type":"boolean","default":false},"stream_options":{"type":"object","additionalProperties":false,"properties":{"include_usage":{"type":"boolean"}}},"n":{"type":"integer","const":1},"response_format":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"enum":["text","json_object"]}}}},"not":{"required":["max_tokens","max_completion_tokens"]}},"BillingReceipt":{"type":"object","required":["status","currency","amount_usd","charged_microusd"],"properties":{"status":{"enum":["settled","pending"]},"currency":{"const":"USD"},"amount_usd":{"type":["string","null"],"description":"Exact settled USD charge, with six decimal places. Null while pending.","pattern":"^\\d+\\.\\d{6}$"},"charged_microusd":{"type":["string","null"],"description":"Integer microdollars as a string; null while pending.","pattern":"^\\d+$"}}},"DecisionRequest":{"type":"object","additionalProperties":false,"required":["model","state","questions"],"properties":{"model":{"type":"string","examples":["typesafe/jev-1.14"]},"state":{"type":["string","object","array"],"description":"Text-only state, up to 12 nesting levels."},"questions":{"type":"object","minProperties":1,"maxProperties":16,"propertyNames":{"pattern":"^[A-Za-z0-9_-]{1,64}$"},"additionalProperties":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"const":"noul"},"instructions":{"type":"string"},"criteria":{"type":"object","additionalProperties":false,"properties":{"true":{"type":"string"},"false":{"type":"string"}}}}},{"type":"object","additionalProperties":false,"required":["type","criteria"],"properties":{"type":{"const":"choice"},"instructions":{"type":"string"},"criteria":{"type":"object","additionalProperties":{"type":"string"},"minProperties":2,"maxProperties":64}}},{"type":"object","additionalProperties":false,"required":["type","criteria"],"properties":{"type":{"const":"score"},"instructions":{"type":"string"},"criteria":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":64}}}]}}}},"DecisionResponse":{"type":"object","required":["id","model","answers","usage","billing"],"properties":{"id":{"type":"string"},"model":{"type":"string"},"answers":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"enum":["noul","score","choice","refusal"]}}}},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"}}},"billing":{"$ref":"#/components/schemas/BillingReceipt"}}}}},"paths":{"/models":{"get":{"operationId":"listModels","summary":"List callable models and their api_kind for this workspace key","responses":{"200":{"description":"OpenAI model list","content":{"application/json":{"schema":{"type":"object","required":["object","data"],"properties":{"object":{"const":"list"},"data":{"type":"array","items":{"type":"object","required":["id","object"],"properties":{"id":{"type":"string"},"object":{"const":"model"},"created":{"type":"integer"},"owned_by":{"type":"string"}}}}}}}}},"401":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}}}}},"/chat/completions":{"post":{"operationId":"createChatCompletion","summary":"Generate a reply without company context or connected tools","description":"Text messages only. Maximum body 1 MB; execution ceiling 10 minutes. No automatic fallback or idempotency. Closing a connection does not guarantee zero cost.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Chat completion, or SSE chunks ending in [DONE] on success. Billing receipts contain the settled charge or pending/null. Streaming includes usage and billing only when stream_options.include_usage is true. Streaming errors carry an error object.","content":{"application/json":{"schema":{"type":"object","required":["id","object","created","model","choices","usage","billing"],"properties":{"id":{"type":"string"},"object":{"const":"chat.completion"},"created":{"type":"integer"},"model":{"type":"string"},"choices":{"type":"array","items":{"type":"object"}},"usage":{"type":"object","required":["prompt_tokens","completion_tokens","total_tokens","cost"],"properties":{"prompt_tokens":{"type":"integer","minimum":0},"completion_tokens":{"type":"integer","minimum":0},"total_tokens":{"type":"integer","minimum":0},"cost":{"type":["number","null"],"minimum":0,"description":"Settled charge in USD; null while the receipt is pending. Use billing.amount_usd for exact decimal arithmetic."}}},"billing":{"$ref":"#/components/schemas/BillingReceipt"}}}},"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"401":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"402":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"403":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"413":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"502":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"503":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}},"504":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"param":{"type":["string","null"]},"code":{"type":"string"}}}}}}}}}}},"/sbrain/public/model-library/detail":{"get":{"operationId":"getPublicModelDetails","summary":"Get model specifications and Central Benchmark evidence","security":[],"parameters":[{"name":"model","in":"query","required":true,"schema":{"type":"string"},"description":"Exact catalog model ID."}],"responses":{"200":{"description":"Public model record, including benchmark receipts, native units, evaluated configurations, collection dates and source links. Missing receipts are not zero scores.","content":{"application/json":{"schema":{"type":"object","required":["id","benchmark"],"properties":{"id":{"type":"string"},"api_available":{"type":"boolean"},"benchmark":{"type":"object","properties":{"snapshot":{"type":["string","null"]},"receipts":{"type":"array","items":{"type":"object"}}}},"catalog_listed":{"type":"boolean","description":"Displayed in the public catalog and search."},"huggingface_url":{"type":"string","format":"uri","description":"Curated Hugging Face repository, when present."},"category":{"type":"string","description":"Task category. For example, decisions covers choices and scores, and ner means named entity recognition."},"api_kind":{"type":["string","null"],"description":"Hosted request contract when available. decisions uses POST /decisions. pii uses POST /privacy/detect or /privacy/redact."},"pricing_contract":{"type":"object","description":"Published first-party model tariff. Rates are USD per million tokens. Check api_available separately.","properties":{"currency":{"type":"string","example":"USD"},"version":{"type":"string","example":"piix-input-v1-2026-11-17"},"rates":{"type":"array","items":{"type":"object","properties":{"input":{"type":"number","example":0.5},"output":{"type":"number","example":0}}}},"minimum_input_tokens_per_item":{"type":"integer","example":256},"minimum_charge_usd_per_item":{"type":"string","example":"0.000128"}}}}}}}},"404":{"description":"Model ID not found"}}}},"/decisions":{"post":{"operationId":"createDecision","summary":"Evaluate typed questions against supplied state","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionRequest"}}}},"responses":{"200":{"description":"Answers and workspace billing receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionResponse"}}}},"400":{"description":"Invalid state or question"},"401":{"description":"Workspace key required"},"402":{"description":"Wallet or spending limit prevents this request"},"403":{"description":"Model unavailable to this key"},"413":{"description":"Request exceeds 64 KiB"}}}},"/privacy/detect":{"post":{"operationId":"piixDetect","summary":"Detect personally identifiable information","description":"Maximum combined text is 64 KiB and 8,192 original tokens. Offsets count Unicode code points from zero with an exclusive end. The wallet applies a 256-token minimum per text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["model"],"properties":{"model":{"type":"string","const":"tracer/piix-560m"},"text":{"type":"string","minLength":1},"texts":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":16},"types":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":80}},"recall":{"type":"number","minimum":0,"maximum":12,"default":0}},"oneOf":[{"required":["text"]},{"required":["texts"]}]}}}},"responses":{"200":{"description":"PIIX results in input order, token usage and wallet receipt.","content":{"application/json":{"schema":{"type":"object","required":["id","model","results","usage","billing"],"properties":{"id":{"type":"string"},"model":{"const":"tracer/piix-560m"},"results":{"type":"array","items":{"type":"object","required":["findings","mask"],"properties":{"findings":{"type":"array","items":{"type":"object","required":["start","end","label","source"],"properties":{"start":{"type":"integer"},"end":{"type":"integer"},"label":{"type":"string"},"source":{"enum":["model","rule"]}}}},"mask":{"type":"array","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer","minimum":0}}}}}},"usage":{"type":"object","required":["input_tokens","billable_input_tokens","output_tokens"],"properties":{"input_tokens":{"type":"integer","minimum":0},"billable_input_tokens":{"type":"integer","minimum":0},"output_tokens":{"type":"integer","minimum":0}}},"billing":{"type":"object","description":"Workspace charge in USD, including charged_microusd and amount_usd when settled."},"unrecognised_types":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Workspace key required"},"402":{"description":"Insufficient credit or spending limit"},"403":{"description":"Model restricted"},"413":{"description":"Request too large"},"429":{"description":"Model busy"},"503":{"description":"Model unavailable"}}}},"/privacy/redact":{"post":{"operationId":"piixRedact","summary":"Redact personally identifiable information","description":"Maximum combined text is 64 KiB and 8,192 original tokens. Offsets count Unicode code points from zero with an exclusive end. The wallet applies a 256-token minimum per text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["model"],"properties":{"model":{"type":"string","const":"tracer/piix-560m"},"text":{"type":"string","minLength":1},"texts":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":16},"types":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":80}},"recall":{"type":"number","minimum":0,"maximum":12,"default":0},"mask":{"type":"string","default":"[REDACTED]","maxLength":32}},"oneOf":[{"required":["text"]},{"required":["texts"]}]}}}},"responses":{"200":{"description":"PIIX results in input order, token usage and wallet receipt.","content":{"application/json":{"schema":{"type":"object","required":["id","model","results","usage","billing"],"properties":{"id":{"type":"string"},"model":{"const":"tracer/piix-560m"},"results":{"type":"array","items":{"type":"object","required":["redacted","spans"],"properties":{"redacted":{"type":"string"},"spans":{"type":"array","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer","minimum":0}}}}}},"usage":{"type":"object","required":["input_tokens","billable_input_tokens","output_tokens"],"properties":{"input_tokens":{"type":"integer","minimum":0},"billable_input_tokens":{"type":"integer","minimum":0},"output_tokens":{"type":"integer","minimum":0}}},"billing":{"type":"object","description":"Workspace charge in USD, including charged_microusd and amount_usd when settled."},"unrecognised_types":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Workspace key required"},"402":{"description":"Insufficient credit or spending limit"},"403":{"description":"Model restricted"},"413":{"description":"Request too large"},"429":{"description":"Model busy"},"503":{"description":"Model unavailable"}}}}}}