身份核验

接口身份核验

调用传思网各项 API（海报设计器、OCR、ASR、TTS 等）前，需要先完成身份核验：申请 API Key → 用 ApiKey 换取对应服务的 Token → 使用 Token 调用业务接口。

1注册账号并申请 API Key

调用任何业务接口前，需要一个有效的 API Key，请按以下步骤获取：

注册传思网账号
访问注册页面创建您的账号；如已有账号请直接登录。

登录控制台
进入「控制台 → API Key 管理」页面。

创建 API Key
点击「新建 API Key」，填写一个便于识别的名称后保存，系统将生成一个以 cs_ 开头的 Key。同一个 ApiKey 可用于换取所有服务（Poster / OCR / ASR / TTS）的 Token，无需按服务分别申请。

立即注册已有账号 · 登录前往 API Key 管理

请妥善保管 API Key：API Key 等同于您的账户凭证，请保存在您自己的服务端，仅用于换取短期有效的 Token；不要在前端代码或公开页面中明文硬编码 ApiKey。

2换取服务 Token

各业务接口均使用 Token 作为请求凭证。Token 由 ApiKey 配合服务类型换取，有效期 1 小时，且只能用于对应服务类型的接口。请在您的服务端调用此接口换取 Token，再将 Token 下发到嵌入页面或前端。

POST https://<传思网域名>/api/auth/access-token

请求体（JSON）

字段	必填	类型	说明
apiKey	是	string	您在步骤 1 中申请的 API Key（`cs_` 开头）。
serviceType	是	string	服务类型，用于约束 Token 适用范围。可选值：`Poster` / `OCR` / `ASR` / `TTS`。

请求体示例：

json

{
  "apiKey": "cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "serviceType": "Poster"
}

响应体（JSON）

字段	类型	说明
data.token	string	32 位字母数字 Token，作为后续接口的鉴权凭证。
data.serviceType	string	Token 对应的服务类型（与请求一致）。
data.expiresAt	string	Token 过期时间，ISO 8601 UTC 格式。
data.expiresIn	number	剩余有效秒数，新签发时为 3600。

json

{
  "success": true,
  "data": {
    "token": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "serviceType": "Poster",
    "expiresAt": "2026-05-17T11:30:00.0000000Z",
    "expiresIn": 3600
  }
}

Token 复用规则：同一个 ApiKey + 同一个 serviceType 在 Token 未过期时会直接返回当前未过期的 Token，不会重复签发。您可放心在每次需要时调用此接口，无需自己缓存（如有需要也可在客户端按 expiresAt 缓存以减少调用次数）。

服务类型隔离：不同服务的 Token 互不通用。例如 Poster Token 只能调用海报相关接口；调用 OCR/ASR/TTS 接口请分别用 serviceType=OCR/ASR/TTS 换取对应 Token。

curl 示例

bash

curl -X POST https://your-webapi.com/api/auth/access-token \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "serviceType": "Poster"
  }'

快速换取 Token

在线测试 POST /api/auth/access-token：填入您的 ApiKey 与服务类型，点击按钮即可换取 Token（未过期时复用现有 Token）。

ApiKey

服务类型