API 平台

认证

当前 /v1 接口都需要 API Key 鉴权，并经过 trace、body limit、access log、metering 和 guardrail 等网关横向能力。

获取 API Key

  1. 打开 Moss API 平台

    进入 Moss API 控制台，使用 Mossland 账号登录。

  2. 进入 API Key 管理平台

    点击「API Key 管理平台」进入，创建一个新的 API Key。

  3. 复制并妥善保存

    API Key 只在创建时完整展示。请保存到服务端环境变量或密钥管理系统。

请求头

每次请求通过 Authorization: Bearer <your-api-key> 携带 API Key。

示例
curl https://api.mosi.cn/v1/audio/speech \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

保存密钥

本地开发时可以把 API Key 放进 .env 文件；线上环境应使用服务端环境变量或密钥管理系统。请勿在前端代码或公开仓库中硬编码 API Key。

严格入参