文档

核心

身份验证

在 LM Studio 中使用 API 令牌

需要 LM Studio 0.4.0 或更高版本。

LM Studio 支持通过 API 令牌进行身份验证,为访问 LM Studio API 提供了一种安全且便捷的方式。

为每个请求要求身份验证

默认情况下,LM Studio 不要求 API 请求进行身份验证。要启用身份验证(以便仅接受带有有效 API Token 的请求),请在“开发者页面 > 服务器设置”中切换开关。

信息

一旦启用,所有通过 REST API、Python SDK 或 TypeScript SDK 发出的请求都需要包含有效的 API Token。请参阅下方的 使用方法

undefined

启用身份验证以要求所有请求提供有效的 API Token

undefined

在服务器设置中管理 Token

创建 API Token

要创建 API Token,请点击服务器设置中的“管理 Token”。这将打开 API Token 模态窗口,您可以在其中创建、查看和删除 API Token。

undefined

API Token 模态窗口

点击“创建 Token”按钮来创建一个 Token。为 Token 提供一个名称并选择所需的权限。

undefined

创建 API Token

创建完成后,请务必复制该 Token,因为它将不会再次显示。

undefined

API Token 已创建

配置 API Token 权限

要编辑现有 API Token 的权限,请点击 API Token 模态窗口中该 Token 旁边的“编辑”按钮。您可以修改 Token 的名称和权限。

undefined

编辑 API Token

API Token 使用方法

在 REST API 中使用 API Token:

下方的示例要求启用 允许调用 mcp.json 中的服务器,并且 mcp.json 中包含 Playwright MCP

curl -X POST \
  https://:1234/api/v1/chat \
  -H "Authorization: Bearer $LM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ibm/granite-4-micro",
    "input": "Open lmstudio.ai",
    "integrations": [
      {
        "type": "plugin",
        "id": "mcp/playwright",
        "allowed_tools": ["browser_navigate"]
      }
    ],
    "context_length": 8000
  }'

在 Python SDK 中使用 API Token

要了解如何在 Python SDK 中使用 API Token,请参阅 Python SDK 指南

在 TypeScript SDK 中使用 API Token

要了解如何在 TypeScript SDK 中使用 API Token,请参阅 TS SDK 指南

本页面源码可在 GitHub 上查看