直接使用 pip install typesafe-sdk 安装官方 Python SDK，要求 Python 3.10+；若版本不足，需通过 pyenv 或 conda 升级；安装后用 python -c "import typesafe_sdk; print(typesafe_sdk.__version__)" 验证，并通过环境变量或 .env 设置 TYPESAFE_API_KEY 认证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接用 pip install typesafe-sdk 就可以完成官方 Python SDK 的安装。
确认 Python 版本是否兼容
Jev 的 SDK 要求 Python 3.10 或更高版本。如果运行 python --version 显示低于 3.10（比如 3.8 或 3.9），建议先升级或新建环境：
- 用
pyenv install 3.10.12 && pyenv local 3.10.12切换本地版本 - 或用
conda create -n jev-env python=3.10 && conda activate jev-env
执行安装命令
在终端中输入以下命令，等待安装完成：
pip install typesafe-sdk
安装成功后，可验证是否可用：
python -c "import typesafe_sdk; print(typesafe_sdk.__version__)"
设置认证密钥
SDK 需要 API 密钥才能调用服务。获取密钥后，通过环境变量配置：
- Linux/macOS：运行
export TYPESAFE_API_KEY="your_key_here" - Windows（CMD）：运行
set TYPESAFE_API_KEY=your_key_here - Windows（PowerShell）：运行
$env:TYPESAFE_API_KEY="your_key_here"
也可以写入 .env 文件，配合 python-dotenv 自动加载。
注意区分其他安装方式
不要混淆 Jev 相关的不同工具包：
-
fast-browser-use是用于浏览器自动化控制的独立库，不是 SDK，不提供client.system_one接口 -
typesafe-sdk才是官方推荐的 Python SDK，封装了认证、重试、类型转换等逻辑 - 如果项目里已有旧版 SDK，建议先卸载：
pip uninstall typesafe-sdk再重装最新版
