API 平台

认证

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

获取 API Key

  1. 打开 Mossland

    进入 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。

严格入参