文档索引
在以下地址获取完整的文档索引：https://docs.typesafe.ai/llms.txt 使用此文件可以在进一步探索之前发现所有可用页面。

异常

处理 TypeSafe API 错误、速率限制、连接故障和超时。

基类异常

typesafe_sdk.TypeSafeError

基类：Exception

SDK 失败的基类异常。

HTTP 错误

typesafe_sdk.TypeSafeAPIError

基类：TypeSafeError

一个包含正文和请求元数据的失败 HTTP 响应。

status

instance-attribute

status = status

HTTP 响应状态码。

body

instance-attribute

body = body

服务器的 JSON 错误正文、纯文本响应，或者如果正文为空则为 None。

headers

instance-attribute

headers = headers

HTTP 响应标头。

endpoint

instance-attribute

endpoint = endpoint

请求方法和 URL（不含凭据、查询参数或片段，如果有的话）。

request_id

property

request_id: str | None

x-typesafe-request-id 响应标头，如果不存在则为 None。

typesafe_sdk.TypeSafeBadRequestError

基类：TypeSafeAPIError

请求无效 (400)。

typesafe_sdk.TypeSafeAuthenticationError

基类：TypeSafeAPIError

身份验证失败（401）。

typesafe_sdk.TypeSafePermissionDeniedError

基类：TypeSafeAPIError

访问被拒绝（403）。

typesafe_sdk.TypeSafeNotFoundError

基类：TypeSafeAPIError

未找到资源（404）。

typesafe_sdk.TypeSafeUnprocessableEntityError

基类：TypeSafeAPIError

请求未能通过服务器验证（422）。

typesafe_sdk.TypeSafeRateLimitError

基类：TypeSafeAPIError

超出速率限制（429）。

retry_after_ms

instance-attribute

retry_after_ms = parse_retry_after(headers)

服务器请求的等待时间（毫秒），如果不可用则为 None。

typesafe_sdk.TypeSafeInternalServerError

基类：TypeSafeAPIError

服务器未能处理请求（5xx）。

连接错误

typesafe_sdk.TypeSafeAPIConnectionError

基类：TypeSafeError，ConnectionError

请求未收到 HTTP 响应即失败。

typesafe_sdk.TypeSafeAPITimeoutError

基类：TypeSafeAPIConnectionError，TimeoutError

请求超过了配置的超时时间。

timeout

instance-attribute

timeout = timeout

请求使用的超时设置，单位为秒或 httpx2.Timeout 对象。

响应验证

typesafe_sdk.TypeSafeAPIResponseValidationError

基类：TypeSafeAPIError

一个成功的 HTTP 响应，但其正文缺失所需数据或结构无效。

field_path

instance-attribute

field_path = field_path

指向出错字段的点号路径，例如 answers.tone.confidence。

args

instance-attribute

args = (
    status,
    body,
    headers,
    field_path,
    endpoint,
)