> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typesafe.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Answers and responses
> Read answers, confidence scores, token usage, and available models returned by the TypeSafe API.
export function SdkSignature({children}) {
async function copy(event) {
const button = event.currentTarget;
const code = button.parentElement.querySelector("pre code");
try {
await navigator.clipboard.writeText(code.textContent);
button.setAttribute("aria-label", "Signature copied");
button.dataset.copied = "true";
} catch {
button.setAttribute("aria-label", "Copy failed; select the signature to copy");
}
setTimeout(() => {
button.setAttribute("aria-label", "Copy signature");
delete button.dataset.copied;
}, 2000);
}
return ;
}
Response
typesafe\_sdk.SystemOneResponse
Bases: `Response`
Answers grouped by question type with model and usage metadata.
request\_id cached property
{"request_id"}
{":"}
{" "}
{"str"}
{"\n"}
The `x-typesafe-request-id` response header.
raw\_http\_response property
```python theme={null}
raw_http_response: httpx2.Response
```
The underlying `httpx2.Response`, exposing status, headers, and body.
model instance-attribute
{"model"}
{":"}
{" "}
{"str"}
{"\n"}
The model used to answer the request.
usage instance-attribute
{"usage"}
{":"}
{" "}
{"Usage"}
{"\n"}
Token usage for the request.
answers class-attribute instance-attribute
{"answers"}{":"}{" "}{"dict"}{"["}{"str"}{","}{" "}{"Answer"}{"]"}{" "}{"="}{" "}{"field"}{"("}{"\n"}{" "}{"default_factory"}{"="}{"dict"}{"\n"}{")"}{"\n"}
All answer objects keyed by question name.
nouls cached property
{"nouls"}
{":"}
{" "}
{"dict"}
{"["}
{"str"}
{","}
{" "}
{"NoulAnswer"}
{"]"}
{"\n"}
Yes/no answers keyed by question name.
choices cached property
{"choices"}
{":"}
{" "}
{"dict"}
{"["}
{"str"}
{","}
{" "}
{"ChoiceAnswer"}
{"]"}
{"\n"}
Choice answers keyed by question name.
scores cached property
{"scores"}
{":"}
{" "}
{"dict"}
{"["}
{"str"}
{","}
{" "}
{"ScoreAnswer"}
{"]"}
{"\n"}
Score answers keyed by question name.
typesafe\_sdk.Usage
Bases: msgspec.Struct
Token counts for a request, when reported by the API.
{"input_tokens"}
{":"}
{" "}
{"int"}
{" "}
{"|"}
{" "}
{"None"}
{" "}
{"="}
{" "}
{"None"}
{"\n"}
Number of input tokens used, or `None` when the API did not report it.
output\_tokens class-attribute instance-attribute
{"output_tokens"}
{":"}
{" "}
{"int"}
{" "}
{"|"}
{" "}
{"None"}
{" "}
{"="}
{" "}
{"None"}
{"\n"}
Number of output tokens used, or `None` when the API did not report it.
Answers
typesafe\_sdk.NoulAnswer
Bases: `wire.NoulAnswer`
A yes/no answer.
noul instance-attribute
{"noul"}
{":"}
{" "}
{"float"}
{"\n"}
Probability of a yes answer, from zero to one.
typesafe\_sdk.ChoiceAnswer
Bases: `wire.ChoiceAnswer`
A selected label and its probabilities.
choice instance-attribute
{"choice"}
{":"}
{" "}
{"str"}
{"\n"}
The selected label.
confidence instance-attribute
{"confidence"}
{":"}
{" "}
{"float"}
{"\n"}
Reported confidence in the selected label.
probabilities instance-attribute
{"probabilities"}
{":"}
{" "}
{"dict"}
{"["}
{"str"}
{","}
{" "}
{"float"}
{"]"}
{"\n"}
Probabilities keyed by label.
typesafe\_sdk.ScoreAnswer
Bases: `wire.ScoreAnswer`
An expected score with its rubric and probabilities.
score instance-attribute
{"score"}
{":"}
{" "}
{"float"}
{"\n"}
Expected score, which may fall between the integer rubric levels.
confidence instance-attribute
{"confidence"}
{":"}
{" "}
{"float"}
{"\n"}
Reported confidence in the score.
legend instance-attribute
{"legend"}{":"}{" "}{"dict"}{"["}{"\n"}{" "}{"int"}{","}{" "}{"str"}{" "}{"|"}{" "}{"dict"}{"["}{"str"}{","}{" "}{"Any"}{"]"}{" "}{"|"}{" "}{"list"}{"["}{"Any"}{"]"}{"\n"}{"]"}{"\n"}
Rubric descriptions keyed by integer score.
probabilities instance-attribute
{"probabilities"}
{":"}
{" "}
{"dict"}
{"["}
{"int"}
{","}
{" "}
{"float"}
{"]"}
{"\n"}
Probabilities keyed by integer score.
typesafe\_sdk.Answer module-attribute
{"Answer"}{":"}{" "}{"TypeAlias"}{" "}{"="}{" "}{"("}{"\n"}{" "}{"NoulAnswer"}{" "}{"|"}{" "}{"ChoiceAnswer"}{" "}{"|"}{" "}{"ScoreAnswer"}{"\n"}{")"}{"\n"}
An answer to a single question, identified by its `type`.
Available models
typesafe\_sdk.ListModelsResponse
Bases: `Response`
The models available to the account.
request\_id cached property
{"request_id"}
{":"}
{" "}
{"str"}
{"\n"}
The `x-typesafe-request-id` response header.
raw\_http\_response property
```python theme={null}
raw_http_response: httpx2.Response
```
The underlying `httpx2.Response`, exposing status, headers, and body.
models instance-attribute
{"models"}
{":"}
{" "}
{"tuple"}
{"["}
{"ModelMetadata"}
{","}
{" "}
{"..."}
{"]"}
{"\n"}
The available models.
Bases: Struct
{"name"}
{":"}
{" "}
{"str"}
{"\n"}
{"description"}
{":"}
{" "}
{"str"}
{"\n"}
{"release_date"}
{":"}
{" "}
{"str"}
{"\n"}