准备 AI Studio API 调用

调用 AI Studio 的工作区资源前，请准备以下三项：

完整的接口列表和请求说明见 AI Studio。

1. 创建个人访问令牌

在访问凭据中创建个人访问令牌，并在创建成功后复制完整值。

2. 获取工作区 ID

AI Studio API 的功能需要在工作区中使用。调用工作流、知识库、数据或智能体等功能前，先选择目标工作区并获取工作区 ID。

在控制台的工作区面板中选择目标工作区，再复制工作区 ID。也可以使用以下 API 获取当前身份可访问的工作区：

export AI_STUDIO_API_KEY='<你的个人访问令牌>'

curl --get "https://api.moi.matrixorigin.cn/v5/workspaces" \
  -H "X-API-Key: $AI_STUDIO_API_KEY"

从响应的 data.workspaces[].id 中选择目标工作区，并保存为环境变量：

export WORKSPACE_ID='<响应中的工作区 ID>'

完整的请求参数和响应字段见查询工作区列表。

3. 调用示例

本示例调用“查看工作流列表”API。使用前两步取得的个人访问令牌和工作区 ID，查看目标工作区中当前身份可以读取的工作流：

curl --get "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps?offset=0&limit=20" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

请求成功时返回 200。data.workflows 是工作流列表，data.total 是符合条件的工作流总数。完整的请求参数和响应字段见查询工作流列表。

调用失败时的检查

先检查实际发送的请求头，再判断是否需要更新令牌。

现象

检查与处理

通过 Bearer 传入个人访问令牌后提示登录失效

改为 X-API-Key，移除同一请求中的 Authorization。需要工作区范围的接口保留 X-Workspace-ID。

返回 ErrApiKeyInvalid

确认完整令牌通过 X-API-Key 发送，再检查是否过期、停用或被更新。

返回 ErrMultipleAuthCredentials

检查是否同时发送 API Key、其他认证头或产品会话 Cookie；API Key 请求保持单一认证方式。

首次请求成功，后续请求出现凭据冲突

检查客户端是否自动保存 Set-Cookie 并在后续请求附带 Cookie。部分部署可能把网关 Cookie 也判为冲突；使用专用 API 客户端，关闭该请求路径的 Cookie 保存与发送，或在每次请求前清理 Cookie jar。

Postman 可检查目标域名的 Cookie jar 和自动 Cookie 设置；使用 requests.Session 时，应同时检查手动设置的 Cookie 请求头与 Session 保存的 Cookie；浏览器使用 API Key 调用时，确认请求的 credentials 配置不会附带登录 Cookie。禁用 Cookie 后仍失败时，记录 HTTP 状态、业务代码和请求时间，联系支持。

下一步

最后更新于