{"id":27562,"library":"zai-sdk","title":"Z.ai SDK","description":"A Python SDK for accessing large model APIs from Z.ai. Version 0.2.2 supports Python >=3.8. Provides clients for chatting, streaming, and embedding with multiple models. Early stage with frequent changes.","status":"active","version":"0.2.2","language":"python","source_language":"en","source_url":"https://github.com/Z-AI-Dev/zai-sdk","tags":["z.ai","llm","sdk","chat","api","big-model"],"install":[{"cmd":"pip install zai-sdk","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false},{"reason":"Data validation","package":"pydantic","optional":true}],"imports":[{"note":"Correct is from zai import ZAI, not import zai","wrong":"import zai","symbol":"ZAI","correct":"from zai import ZAI"},{"note":"Used for chat message objects","symbol":"ChatMessage","correct":"from zai import ChatMessage"}],"quickstart":{"code":"import os\nfrom zai import ZAI\n\nclient = ZAI(api_key=os.environ.get('ZAI_API_KEY', ''))\nresponse = client.chat.completions.create(\n    model=\"zai-gpt-4o\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\nprint(response.choices[0].message.content)","lang":"python","description":"Initialize client with API key from environment variable and make a chat completion."},"warnings":[{"fix":"Use pip install zai-sdk, then from zai import ZAI","message":"The package name on PyPI is 'zai-sdk' but the import is 'from zai'. Do not use 'import zai_sdk'.","severity":"gotcha","affected_versions":"ALL"},{"fix":"Pass api_key to ZAI(api_key='your_key')","message":"Version 0.2.x changed the client initialization signature. Old code used ZAI() with no arguments, now requires api_key parameter.","severity":"breaking","affected_versions":"<0.2.0"},{"fix":"Use client.chat.completions.create(model=..., messages=...)","message":"The method 'client.complete()' is deprecated in favor of 'client.chat.completions.create()'.","severity":"deprecated","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Correct import: from zai import ZAI","cause":"Trying to import from zai_sdk instead of zai.","error":"ImportError: cannot import name 'ZAI' from 'zai_sdk'"},{"fix":"Set ZAI_API_KEY environment variable or pass api_key to ZAI(api_key='...')","cause":"API key not set or client not initialized correctly.","error":"AttributeError: 'NoneType' object has no attribute 'create'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}