快速入门

准备账号

1. 注册阿里云账号，请参见注册阿里云账号。

2. 个人实名认证，请参见个人实名认证。

3. （仅使用旧版接口或MQ回调才需要该步骤）创建并授权RAM用户，请参见创建RAM用户。关于RAM用户的更多信息，请参见什么是访问控制。联系主账户在RAM控制台按以下步骤授权，使用通义听悟管控台时需要读取对象存储OSS和Rocket MQ的列表。如果RAM子账户没有读取对象存储OSS和Rocket MQ的列表的权限，会出现下图提示：

   1. 在RAM控制台的权限管理 > 权限策略中，创建自定义权限策略，权限策略配置内容如下：

      {
          "Version": "1",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "oss:ListBuckets",
                  "Resource": "acs:oss:*:*:*"
              },
              {
                  "Effect": "Allow",
                  "Action": "mq:QueryInstanceBaseInfo",
                  "Resource": "acs:mq:*:*:*"
              }
          ]
      }

   2. 在RAM控制台的身份管理 > 用户中，找到RAM子账户，单击操作列的添加权限，选择上一步创建的自定义策略，和系统策略中的“AliyunTingwuFullAccess”管理通义听悟服务（Tingwu）的权限，授予RAM子账户。

创建AccessKey

1. 创建阿里云账号的AccessKey

   登录RAM访问控制台，使用阿里云账号创建AccessKey。具体操作，请参见创建AccessKey。

2. 创建RAM用户的AccessKey（可选）

   使用阿里云账号登录RAM访问控制台，为RAM用户创建AccessKey。具体操作，请参见创建AccessKey

   

开通服务

1. 登录通义听悟控制台。

2. 在概览页单击立即开通。

3. 在产品开通页面，选择服务类型。

   1. 选择试用。新开通服务的用户可免费试用90天。

   2. 选择商用。开通后按通过接口请求的时长计量计费，通义听悟API服务会根据实际使用量从您的阿里云账户余额中扣费。

   说明

   商用版详细计费规则，请前往计费说明查看。

   服务能力	免费试用期间权益	试用期过后如何继续使用
   实时记录	实时并发限制：2路。	在服务管理与开通页面将实时记录服务升级为商用版。 升级为商用版之后，进入后付费按时长计费模式。 商用版实时并发限制：200路
   音视频文件记录	上传文件：每天免费使用额度为2小时（音频时长）。 当日免费额度用完后，需等待24小时后才可以继续使用。	在服务管理与开通页面将音视频文件记录服务升级为商用版。 升级为商用版之后，进入后付费按时长计费模式。

创建项目

1. 在通义听悟控制台左侧导航栏，单击我的项目。

2. 在我的项目页，单击创建项目（如首次创建项目则也可单击立即创建）。

   

   1. 输入项目名称。

   2. 选择回调方式。

      • 如选择HTTP post协议，需要输入URL。通义听悟会向配置的HTTP URL发送post请求，返回的HTTP status为200则检查通过。

      • 如选择不设置回调主动轮询，则需要调用API轮询接口。

      • 如选择Rocket MQ 的 HTTP，需要先创建一个Rocket MQ4.0实例，创建以“TOPIC_TINGWU_”开头的topic。通义听悟会向配置的RocketMQ通过HTTP协议发送消息，消息写入成功则检查通过。

        

        说明

        • 通义听悟API服务的RAM账号将获取 Rocket MQ 的服务授权。仅支持Rocket MQ 4.0实例，且topic必须以“TOPIC_TINGWU_”开头。

        • 选择HTTP post协议或Rocket MQ回调方式，通义听悟会向配置的回调地址发送连通性检查消息：{"Code":"0","Data":{"Test":"checkSyncConf+时间戳"},"Message":"success.","RequestId":"xxxxxx"}。

   3. 选择对象存储（仅旧版接口需要），如下拉列表中无所需Bucket可单击右侧创建对象存储bucket。

      通义听悟会向项目配置的OSS Bucket里写入一个测试文件tingwu/initfile.txt，写入成功则检查通过。

      说明

      建议Bucket与项目的Region相同，跨Region会降低数据存储成功率；通义听悟将在此Bucket下，按每次请求的以tingwu开头的object写入处理结果数据。

   4. 选择MQ回调或设置OSS时，听悟服务会自动判断您的子账号权限。若无授权，请联系主账号按本文档顶部“准备账号第3步进行操作”。

   5. 输入项目描述（可选）。

测试效果（可选）

1. 在通义听悟控制台的我的项目列表页，单击项目列表右侧操作列的详情及语音服务效果测试。

   

2. 测试中文、英文和粤语的识别准确率。

   1. 当测试语言如果选择中文/英文/粤语，选择测试方式为麦克风输入，单击开始录音，可查看实时识别的转写结果，60s后自动停止识别。单击确认，返回项目列表页。

      

   2. 当测试语言如果选择中文/英文/粤语，选择测试方式为音频文件，单击上传本地文件，上传成功后，可查看识别后的转写结果，上传的音频文件可在线播放。单击确认，返回项目列表页。更多语种、大模型及翻译功能的免费可视化测试，请移步通义听悟网页。

      

开发接入

根据以上几步获取到账号对应的AccessKey ID、AccessKey Secret以及项目Appkey，必须确保这几项数值归属同一阿里云账号或同一RAM用户。