开通服务
体验声网对话式 AI 引擎前,你需要先在声网控制台创建项目并开通对话式 AI 引擎服务,获取 App ID、客户 ID 和客户密钥等调用 RESTful API 时所需的参数。
登录声网控制台
如果你是第一次使用声网服务,点击注册账号前往进行注册。注册成功后会自动登录。
如果你已经拥有声网账号,可以直接登录控制台。
注册和登录过程中如果遇到疑问,可以查看快速开始。
创建声网项目
成功登录控制台后,按照以下步骤创建一个声网项目:
- 展开控制台左上角下拉框,点击创建项目按钮。
- 在弹出的对话框内,依次选择项目类型,输入项目名称,选择场景标签和鉴权机制。其中鉴权机制推荐选择安全模式,调试模式的安全性较低。
为使用对话式 AI 引擎服务创建项目时,项目类型选择通用项目。
获取 App ID
成功创建项目后,声网会给每个项目自动分配一个 作为项目唯一标识。你可以直接在总览页面的项目信息栏,点击 App ID 右侧的复制按钮来获取当前项目的 App ID。
你需要保存好复制的 App ID,后续调用 API 进行初始化等操作时需要传入你获取的 App ID。
开通对话式 AI 引擎
按照以下步骤,在声网控制台为你的项目开通对话式 AI 引擎服务:
- 登录声网控制台,在页面左上角下拉框选择需要开通对话式 AI 引擎服务的项目。
- 在左侧导航栏依次访问全部产品-对话式 AI 引擎。
- 在对话式 AI 引擎页面,进入功能配置,之后点击状态按钮启用对话式 AI 引擎服务。
- 启用后,在功能配置下看到如下页面,即代表该项目的对话式 AI 引擎服务已成功开通:
获取客户 ID 和客户密钥
声网 RESTful API 使用 HTTP 基本认证进行鉴权。进行 HTTP 基本认证时,你需要使用声网提供的生成一个 Base64 算法编码的凭证,并填入 HTTP 请求头部的 Authorization 字段中。
参考以下步骤获取客户 ID 和客户密钥:
- 在声网控制台左侧菜单点击设置 > RESTful API,进入 RESTful API 页面。
- 在 RESTful API 页面,点击添加密钥按钮,就会生成一组客户 ID 和客户密钥。
- 在对应的客户密钥栏点击下载按钮。仔细阅读弹窗提示后,点击下载。请妥善保管下载的
key_and_secret.txt文件,其中key为客户 ID,secret为客户密钥。
客户 ID 和客户密钥仅用于访问 RESTful API。客户密钥只能下载一次,下载后将不在控制台保存,请妥善保管。
获取临时 Token
对于机制为安全模式的项目,在后续调用 API 进行加入频道等操作时,你还需要传入频道名和 来对用户进行鉴权。
为方便体验和测试,在 App 调试阶段你可以先从控制台获取临时 Token(有效期为 24 小时),无需自行部署 Token 服务器。但在 App 正式上线前,你必须在自己的服务端部署并生成 Token。
在控制台左上角的下拉框,切换到你想要获取临时 Token 的项目,然后按如下步骤获取临时 Token:
- 在总览页面的项目信息栏,点击临时 Token 生成器。
- 在生成临时 Token 页面,点击添加产品。
- 选择 RTC 产品,输入频道名,例如
testChannel。然后保存好输入的内容。 - 点击确认。
- 成功生成临时 Token 后,点击 Token 右侧的复制按钮,保存好复制的 Token。