WyseOS
首页Python SDK用户手册
WyseOS

Introduction

📖 文档📜 核心概念

Users

📋 用户手册

Developers

🚀 Python SDK
📋 安装指南✨ 快速开始🔑 身份验证🐍 示例⚙️ 发布说明🔌 API 参考🔧 故障排除

Changelogs

Others

联系我们
🚀 Python SDK

🔑 身份验证

Python SDK 支持双认证:

  • api_key
  • jwt_token

在 ClientOptions 或 mate.yaml 中二选一使用。

1. 获取凭据

  1. 登录 mate.wyseos.com
  2. 进入控制台
  3. 创建 API Key,或使用你现有认证流程中的 JWT Token

2. 使用 mate.yaml 配置(推荐)

mate:
  # Use one of api_key or jwt_token
  api_key: "your-api-key"
  # jwt_token: "your-jwt-token"

  base_url: "https://api.wyseos.com"
  timeout: 30

加载配置:

from wyseos.mate import Client
from wyseos.mate.config import load_config

client = Client(load_config("mate.yaml"))

3. 代码内配置

from wyseos.mate import Client, ClientOptions

# API Key
client = Client(ClientOptions(api_key="YOUR_API_KEY"))

# JWT Token
client = Client(ClientOptions(jwt_token="YOUR_JWT_TOKEN"))

4. Header 和 Query 映射

  • HTTP:
    • api_key -> x-api-key
    • jwt_token -> Authorization(不带 Bearer 前缀)
  • WebSocket URL query:
    • ?api_key=...
    • ?authorization=...

5. 说明

  • 生产环境不要把凭据硬编码到代码中。
  • 优先使用 mate.yaml 与密钥管理系统。

✨ 快速开始

上一页

🐍 示例

下一页

目录

1. 获取凭据
2. 使用 mate.yaml 配置(推荐)
3. 代码内配置
4. Header 和 Query 映射
5. 说明