跳到主要内容

认证

远程 CLI / SDK 通过 Bearer API Key 访问 EnvPlatform。浏览器登录会话用于平台页面，不代替程序客户端的 API Key。

Create a key​

  1. 使用已开通的账号登录平台。
  2. 打开侧栏 API Keys，选择 Create API Key 并填写名称。
  3. 复制密钥并保存在私有环境或密钥管理器中。关闭创建对话框后，列表不会再次显示完整密钥。
  4. 不再使用时在 API Keys 页面撤销；撤销后客户端需要换用有效密钥。

Configure the client​

export ENVLOOP_BASE_URL=https://api.envloop.ai
export ENVLOOP_API_KEY='YOUR_ENVLOOP_API_KEY'
el job list --limit 10

该命令假设 el 已在当前 shell 环境安装。源码安装用户可在仓库目录使用 uv run --no-sync el。

SDK 使用同一配置：

from envloop import Client

with Client.remote() as client:
    print(client.jobs.list(limit=10))

Workspace selection​

通常只需地址和 Key。省略工作区时由服务端选择默认已授权 workspace；需要指定时使用 ENVLOOP_WORKSPACE_ID、CLI 全局 --workspace-id 或 SDK workspace_id=。指定 ID 不会授予访问权限，平台仍验证成员关系及 Key 限制。

Local development​

本地完整平台已启动时，地址使用 http://127.0.0.1:5173/api/，端口改变时相应调整。此入口经网页代理转发至 Worker，可使用同样的 API Key。

可信本地 JobMaster 可使用无凭据 loopback HTTP（例如 http://127.0.0.1:8000），这是开发模式，不代表生产认证通过。公网连接必须使用 HTTPS；URL 内的凭据、query / fragment 和自动重定向被拒绝。Key 只在 Authorization 请求头发送。

不要把 EnvLoop API Key 写进 Task Profile、任务源码或网页公开环境变量。完整优先级见 Configuration。