How is the async client used?

As an async context manager with await client.system_one(...), taking state plus a nonempty map of Noul, Choice, and Score questions. client.models.list() returns names, descriptions, and release dates.

What about response_model and extra_body?

response_model parses the JSON body into a Pydantic model, defaulting to SystemOneResponse; extra_body is shallow-merged last, so a colliding state, model, or questions key overrides the typed fields. Bodies are not redacted in logs.

What resources does the async client manage on close?

A custom transport and an http_client are both closed when the SDK client closes, and the two are mutually exclusive: supplying both raises ValueError. A supplied client's timeout is inherited when no timeout is set.

How do I configure async client logging?

The SDK logs to the typesafe_sdk logger, configurable through standard logging, or set TYPESAFE_LOG_LEVEL to debug, info, and so on for a quick default. Secret headers are redacted; request and response bodies are not.

Can I override retries or timeouts for a single async call?

Yes. system_one accepts per-call retry and timeout overrides that apply to that request only, plus extra_headers. The client-level values stay in place for later calls.

How do I list models with the async client?

client.models is a cached property exposing the Models API resource, so await client.models.list() returns the available models. The accessor matches the sync client, just awaited.

What does the async constructor raise on bad input?

TypeSafeError when the API key is missing or invalid or the timeout is invalid, and ValueError when both transport and http_client are supplied.

OfficialJev Repos & SDKs

Python Async Client

AsyncTypeSafeClient: async system_one calls, model listing, per-call retry and timeout overrides, and an optional Pydantic response model.

See highlights

Open docs.typesafe.ai

Format: Docs
Published by: TypeSafe AI
Last verified: Oct 2026

Tagsofficial docs sdk python

Works forJev for Scoring

Used inJev for Software & DevTools

Languages: Python

Highlights

Use it as an async context manager. system_one takes state plus a nonempty map of Noul, Choice, and Score questions.
response_model parses the JSON body into a Pydantic model. Omit it and you get SystemOneResponse.
extra_body is shallow-merged last, so a colliding state, model, or questions key overrides the typed fields.
The key comes from TYPESAFE_API_KEY. Empty keys, internal whitespace, control characters, and non-ASCII are rejected.
client.models.list() returns names, descriptions, and release dates. transport and http_client cannot both be set.

Quickstart

python

async with AsyncTypeSafeClient() as client:
    result = await client.system_one(
        state="I was charged twice. Please help.",
        questions={
            "billing": Noul(instructions="Is this about billing?"),
            "tone": Choice(
                instructions="What is the tone?",
                criteria={"calm": None, "angry": None},
            ),
        },
    )

Watch out

Request and response bodies are not redacted in typesafe_sdk logs. Secret headers are.

Questions about this entry

Short answers drawn from the linked project or page.

Related terms

Glossary definitions related to this entry.

Client SDK

More Jev resources like this

Python SDK Questions

How the Python SDK types questions: Noul, Choice, and Score as objects or dictionaries, including optional JSON instructions and criteria.