Do environment variables or constructor options win?

Explicit options do, and empty or whitespace-only environment values are ignored. The key comes from TYPESAFE_API_KEY, and empty keys, internal whitespace, control characters, and non-ASCII are rejected.

How do I turn retries off?

Pass RetryPolicy(max_retries=0). A custom transport and http_client cannot both be set, and remember this client blocks the calling thread — the async client is on a separate page.

How do I list available models?

client.models is a cached property exposing the Models API resource, so client.models.list() returns the models. It is the same resource the async client exposes, called without await.

Where do the sync client's logs go?

To the typesafe_sdk logger, configurable through standard logging or the TYPESAFE_LOG_LEVEL variable. Secret headers are redacted from output, but request and response bodies are not.

Can I override retries or timeouts for one call?

Yes. system_one accepts per-call retry and timeout overrides that apply to that request only, plus extra_headers. Client-level values remain for other calls.

How does extra_body merge into the request?

It is shallow-merged over the body after state, model, and questions are set, last write wins. A colliding key overrides the typed value, and object values are replaced rather than deep-merged.

What does the sync client 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 Sync Client

TypeSafeClient, the synchronous Python client: ask questions, list models, and set the key, model, retry policy, and HTTP timeout.

See highlights

Open docs.typesafe.ai

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

Tagsofficial docs sdk python

Works forJev for Classification

Used inJev for Software & DevTools

Languages: Python

Highlights

Explicit options override environment variables. Empty or whitespace-only environment values are ignored.
The key comes from TYPESAFE_API_KEY. Empty keys, internal whitespace, control characters, and non-ASCII are rejected.
RetryPolicy(max_retries=0) turns retries off. A custom transport and http_client cannot both be set.
Logs go to the typesafe_sdk logger. Secret headers are redacted. Request and response bodies are not.

Quickstart

python

from typesafe_sdk import TypeSafeClient

with TypeSafeClient() as client:
    models = client.models.list()

Watch out

This client blocks the calling thread. The async client is a separate page.

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 Changelog

Release notes for the official Python SDK, from the 14 September 2026 public release through the Pydantic migration and the HTTP/2 extra.