Skip to content
Subaya

认证与 API 密钥

Subaya 针对同一个 API 支持两种认证模式。

API 密钥——SUBAYA_API_KEY（agent 与 CI）

Section titled “API 密钥——SUBAYA_API_KEY（agent 与 CI）”

最简单的路径，也是用于 AI agent 和 CI 流水线的方式。设置环境变量后，每个 suya 命令 （以及平台 API）都会读取它：

Terminal window
export SUBAYA_API_KEY="sk_..."
suya auth whoami      # confirm the identity the key resolves to

无需浏览器、无交互步骤——非常适合无头环境。从控制台签发和管理密钥。

OAuth 浏览器登录（人类）

Section titled “OAuth 浏览器登录（人类）”

用于工作站上的交互式使用：

Terminal window
suya auth login                 # opens a browser (loopback redirect)
suya auth login --no-browser    # manual-code fallback for remote/headless shells

CLI 会在本地（~/.config/suya/ 下）存储所得到的令牌。检查或清除它：

Terminal window
suya auth status    # local status, without calling the server
suya auth logout    # log out and revoke the local token

优先级

Section titled “优先级”

当存在多于一个凭据时，suya 按以下顺序解析：

  1. --token 全局标志
  2. SUBAYA_API_KEY
  3. 本地存储的 OAuth 令牌（~/.config/suya/auth.json）

指向不同的主机

Section titled “指向不同的主机”

如果你需要面向非默认的 API 端点，所有命令都接受 --host（默认 https://subaya-dev.com）。

后续步骤

Section titled “后续步骤”