# 生成 SDK Token (/zh-CN/api-reference/api-ref/ppt-conversion-service/generate-sdk-token)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

生成一个 SDK Token。

- OpenAPI: /openapi/ppt-conversion-service/rest-api.zh-CN.yaml
- Operation ID: post-v5-tokens-teams
- Method: POST
- Path: /v5/tokens/teams
- Endpoint: https://api.netless.link/v5/tokens/teams

## Servers

- https://api.netless.link

## Parameters

- `region` (header, required, string) - 指定处理该请求的数据中心，取值如下：

- `cn-hz`：中国杭州，服务区覆盖中国大陆地区及其他数据中心未覆盖的区域。
- `us-sv`：美国硅谷，服务区覆盖北美洲、南美洲。
- `sg`：新加坡，服务区覆盖新加坡、东亚、东南亚。
- `in-mum`：印度孟买，服务区覆盖印度。
- `eu`：欧洲（法兰克福），服务区覆盖欧洲。
  - Allowed: `cn-hz` | `us-sv` | `sg` | `in-mum` | `eu`

## Request body

- `accessKey` (string, required) - 访问密钥 Access Key (AK)，可在声网控制台获取，详见[获取互动白板项目的安全密钥](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service#获取互动白板项目的安全密钥)。
- `secretAccessKey` (string, required) - 私有访问密钥 Secret Access Key (SK)，可在声网控制台获取，详见[获取互动白板项目的安全密钥](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service#获取互动白板项目的安全密钥)。
- `lifespan` (integer, required) - Token 的有效时间（ms）。设为 `0` 表示永久有效。
- `role` (string, required) - 权限角色，取值如下：

- `admin`
- `writer`
- `reader`
详见 [Token 的类型与权限](/zh-CN/realtime-media/whiteboard/concepts#token)。

### Request body example

```json
{
  "accessKey": "BUxxxxxxrc",
  "secretAccessKey": "CxxxxxxxauY3",
  "lifespan": 3600000,
  "role": "admin"
}
```

## Responses

### 201

若返回的状态码为 `201` 则表示请求成功。响应包体中包含本次请求的结果。

若返回的状态码不为 `201` 则表示请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/ppt-transcoding/reference/response-code)了解可能的原因。

- `id` (string)

## Response examples

### 201

```json
{
  "id": "string"
}
```
