مرجع › مستندات Jev

SDK پایتون

نصب SDK پایتون TypeSafe و شروع با فراخوانی‌های همگام یا ناهمگام.

آخرین به‌روزرسانی: مدل: jev-1.13.0 منبع بازبینی‌شده در منبع انگلیسی

SDKهای کلاینت پرسش‌ها و پاسخ‌های تایپ‌شده ارائه می‌کنند و با سیاست retry پیش‌فرض خود تلاش مجدد را خودکار انجام می‌دهند. نیازمند Python ≥ ۳٫۱۰.

from typesafe_sdk import Noul, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        state="My card was charged twice.",
        questions={"refund": Noul(instructions="Does the customer request a refund?")},
    )
    print(response.answers["refund"].noul)

import asyncio
from typesafe_sdk import AsyncTypeSafeClient, Noul


async def main() -> None:
    async with AsyncTypeSafeClient() as client:
        response = await client.system_one(
            state="My card was charged twice.",
            questions={"refund": Noul(instructions="Does the customer request a refund?")},
        )
        print(response.answers["refund"].noul)


asyncio.run(main())

متغیرهای محیطی و پیش‌فرض‌ها

ثابت	مقدار	توضیح
API_KEY_ENV	TYPESAFE_API_KEY	متغیر محیطی کلید API
BASE_URL_ENV	TYPESAFE_BASE_URL	متغیر محیطی آدرس پایه‌ی API
DEFAULT_MODEL_ENV	TYPESAFE_DEFAULT_MODEL	متغیر محیطی مدل پیش‌فرض
LOG_LEVEL_ENV	TYPESAFE_LOG_LEVEL	متغیر محیطی سطح لاگ
DEFAULT_BASE_URL	https://api.typesafe.ai	آدرس پایه‌ی پیش‌فرض
DEFAULT_MODEL	jev-latest	مدل پیش‌فرض
DEFAULT_TIMEOUT	10.0	تایم‌اوت پیش‌فرض هر عملیات HTTP (ثانیه)

مدیریت خطا

from typesafe_sdk import (
    TypeSafeClient,
    TypeSafeAuthenticationError,
    TypeSafeRateLimitError,
    TypeSafeAPIError,
)

try:
    with TypeSafeClient() as client:
        response = client.system_one(state=state, questions=questions)
except TypeSafeRateLimitError as e:
    # تلاش‌های خودکار تمام شده؛ مکث پیشنهادی سرور:
    print("retry after (ms):", e.retry_after_ms)
except TypeSafeAuthenticationError:
    print("کلید API نامعتبر است")
except TypeSafeAPIError as e:
    print(e.status, e.request_id, e.body)