# 调用 API

完成本页后，你将使用个人访问令牌列出当前账号可见的工作区，并保存一个工作区 ID 供后续请求使用。完整的接口列表和请求说明见 [AI Studio](../../api/ai-studio/index.md)。

## 1. 准备接入信息

从当前环境的开发者接入信息取得完整 AI Studio API 服务地址，并准备个人访问令牌：

```bash
export PRODUCT_API_BASE_URL='<以 /newmoi 结尾的 AI Studio API 服务地址>'
export PRODUCT_API_KEY='<你的个人访问令牌>'
```

AI Studio API 服务地址必须包含 `/newmoi`。AI Studio API 使用 `X-API-Key`，不要改用 Genesis 服务地址或 `Authorization: Bearer`。

## 2. 列出工作区

```bash
curl "$PRODUCT_API_BASE_URL/workspaces" \
  -H "X-API-Key: $PRODUCT_API_KEY" \
  -H "Accept: application/json"
```

工作区发现请求不发送 `X-Workspace-ID`。成功响应的 `data.workspaces` 是当前身份可见的工作区列表。

## 3. 保存工作区 ID

从 `data.workspaces[].id` 中选择目标工作区：

```bash
export WORKSPACE_ID='<响应中的工作区标识>'
```

后续工作区资源请求应同时发送：

```text
X-API-Key: <PERSONAL_ACCESS_TOKEN>
X-Workspace-ID: <WORKSPACE_ID>
```

如果列表为空，先确认当前账号已创建、加入或接受目标工作区邀请，不要根据工作区名称自行构造 ID。

## 下一步

- 管理工作区成员和权限：见 [用户与权限](../../api/ai-studio/users-permissions/index.md)
- 运行和跟踪工作流：见 [运行、恢复和重试工作流作业](../../api/ai-studio/data-processing/workflow-jobs-recovery.md)