Python SDK

pip install typesafe-sdk   # Python 3.10 or newer

from typesafe_sdk import RetryPolicy, TypeSafeClient client = TypeSafeClient(    base_url="https://api.vakyn.com",  # VAKYN MAX, without /v1    api_key="vk_your_key_here",  # from vakyn.com/console/keys    timeout=30.0,  # seconds per attempt    retry=RetryPolicy(max_retries=4),  # 429 and 5xx are retried)print([m.name for m in client.models.list().models])

from typesafe_sdk import Choice, Noul, Score, TypeSafeClient # Reads TYPESAFE_BASE_URL (https://api.vakyn.com) and TYPESAFE_API_KEY from the environment.client = TypeSafeClient()result = client.system_one(    state={        "channel": "email",        "customer": {"plan": "team", "seats": 12, "months_active": 14},        "message": "Since this morning nobody on our team can sign in. We have a client demo at 3pm.",    },    questions={        "outage": Noul(instructions="Is the customer unable to use the product?"),        "team": Choice(            instructions="Which team should handle this?",            criteria={                "billing": "Invoices, charges and refunds",                "access": "Sign-in, passwords and permissions",                "product": "Bugs and how-to questions",            },        ),        "urgency": Score(            instructions="How soon does this need a reply?",            criteria=["Can wait", "Today", "Within the hour"],        ),    },)print(result.nouls["outage"].noul, result.choices["team"].choice, result.scores["urgency"].score)

import asyncio from typesafe_sdk import AsyncTypeSafeClient, Noul MESSAGES = [    "Where is my parcel?",    "Please cancel my subscription at the end of the month.",    "Your app crashes when I open settings.",]  async def main() -> None:    # Reads TYPESAFE_BASE_URL (https://api.vakyn.com) and TYPESAFE_API_KEY from the environment.    async with AsyncTypeSafeClient() as client:        # The server queues what it can take and answers 429 beyond that;        # the SDK retries 429 after the delay the server asks for.        results = await asyncio.gather(*(            client.system_one(state=m, questions={"cancel": Noul(instructions="Does the customer want to cancel?")})            for m in MESSAGES        ))    for m, r in zip(MESSAGES, results):        print(f"{r.nouls['cancel'].noul:.2f}  {m}")  asyncio.run(main())

from typesafe_sdk import (    Score,    TypeSafeAPIConnectionError,    TypeSafeAuthenticationError,    TypeSafeBadRequestError,    TypeSafeClient,    TypeSafeRateLimitError,    TypeSafeUnprocessableEntityError,) # Reads TYPESAFE_BASE_URL (https://api.vakyn.com) and TYPESAFE_API_KEY from the environment.client = TypeSafeClient()try:    result = client.system_one(        state="Rate this.",        questions={"rating": Score(criteria=[f"level {i}" for i in range(11)])},  # one level too many    )    print(result.request_id)except TypeSafeBadRequestError as e:  # 400: over a limit, or an unknown model    print(e.status, e.body["detail"], e.request_id)except TypeSafeUnprocessableEntityError as e:  # 422: the body does not match the schema    print(e.body["detail"])except TypeSafeAuthenticationError:  # 401: missing, wrong or revoked key    print("check TYPESAFE_API_KEY")except TypeSafeRateLimitError:  # 429 that outlasted the retries    print("server busy")except TypeSafeAPIConnectionError:  # no answer: wrong base URL, server down, timeout    print("cannot reach the server")