2026阿里云国际版语音服务Voice Service实战教程:DID号码申请、语音验证码接入与资源包计费测算
Meta Description: 手把手讲解阿里云国际版语音服务(Voice Service / VMS):与邮件推送、短信服务的触达层边界表、DID号码月费与17国通话费率全表、资源包点数单价反推、DID月费与通话费的成本构成占比测算、企业资质与号码申请七步实操、Dyvmsapi-intl AP…
- 语音服务在"触达层"里的位置:与邮件、短信的边界
- 能力与硬边界:四个能力 + 六条必须先知道的限制
- 价格全景(一):DID 月费只有一个价,但只公开了三个国家
- 价格全景(二):17 国通话费率全表,以及用"点数"反推单价的方法
- 核心发现:语音服务的资源包是"零折扣预付",与短信、邮件完全相反
- 成本测算:DID 月费与通话费,谁才是账单大头?
- 实操(一):从企业资质到拿到号码的七步
- 实操(二):API 接入五步
Meta Description: 手把手讲解阿里云国际版语音服务(Voice Service / VMS):与邮件推送、短信服务的触达层边界表、DID号码月费与17国通话费率全表、资源包点数单价反推、DID月费与通话费的成本构成占比测算、企业资质与号码申请七步实操、Dyvmsapi-intl API接入与常见坑,附十问FAQ。
关键词:阿里云国际版语音服务、Voice Service、VMS、DID号码、语音验证码、语音通知、群呼、Dyvmsapi-intl、语音资源包、阿里云国际版教程
一、语音服务在"触达层"里的位置:与邮件、短信的边界
阿里云国际版的云通信产品线里,「触达用户」这件事被拆成了好几条腿。本站此前已经分别写过邮件推送 DirectMail(2026-09-24 篇)与短信服务 SMS(2026-10-01 篇)。本文补上第三条腿:语音服务 Voice Service(文档里的产品代号是 VMS)。
先把可选的触达通道摆在一张表里,读者一眼就能看出自己该看哪一篇:
| 触达通道 | 阿里云国际版产品 | 本站对应文章 | 典型用途 |
|---|---|---|---|
| 邮件 | Direct Mail(DirectMail) | 2026-09-24 篇 | 批量营销邮件、通知类邮件、验证邮件 |
| 短信 | Short Message Service(SMS) | 2026-10-01 篇 | OTP 验证码、系统告警、营销短信 |
| 语音(本文) | Voice Service(VMS) | 本文 | 语音验证码、语音通知、批量群呼、DID 热线 |
| App 推送 | 暂无对应国际版独立产品文章 | — | 站内推送、App 通知栏 |
再看一张边界表,把语音服务和最容易混淆的几样东西切开。这张表的作用不是罗列功能,而是让读者一眼看出「同样叫语音,它们的前提条件完全不同」:
| 对比对象 | 相似之处 | 前提条件差异(决定你是否该用 VMS) |
|---|---|---|
| 短信 SMS | 都是 OTP / 通知触达通道 | 短信是文本、到达快但易被拦截与延迟;语音是电话呼入,用户必须接听,但抗拦截能力强 |
| 邮件 DirectMail | 都是批量触达 | 邮件是异步、可留存;语音是实时、不可留存、必须接听 |
| 自建 SIP 中继 + 呼叫中心 | 都能打电话 | 自建需要自己谈运营商、办号码资质、建设坐席系统;VMS 是托管式 API,但不支持坐席实时全双工通话(详见第二节) |
| 百炼大模型(Model Studio)的语音合成 | 都能"说话" | 百炼是把文本转成音频文件,供你自己的通道播放;VMS 是把音频直接拨号播给对方听。两者可以配合:用百炼(或直接使用 VMS 的 TTS 模板)生成话术,用 VMS 外呼 |
📝 一句话选型:如果你要做的是「把一段话通过电话播给某个号码听」,用 VMS;如果你要做的是「让真人坐席和客户实时双向通话」,VMS 目前做不到,需要 SIP 中继或自建呼叫中心。
二、能力与硬边界:四个能力 + 六条必须先知道的限制
2.1 官方定义的四个能力
国际站文档把 Voice Service 的能力归纳为四类,这也是它全部的 API 能力边界:
| 能力 | 官方描述 | 典型场景 |
|---|---|---|
| DID 号码服务 | 运营商提供的直线呼入号码服务(Direct Inward Dialing) | 企业官网咨询热线、广告投放回呼号码 |
| 语音通知 | 通过 API 拨号,接通后播放 TTS 或预录音频 | 订单提醒、风险告警、故障通知、退款提醒 |
| 语音验证码 | 通过 API 拨号,接通后播报验证码 | 登录验证、交易验证等安全校验 |
| 群呼(Group Voice Call) | 同时对多个号码拨号,按语音模板广播 | 批量通知、营销与推广 |
官方对「语音通知 / 语音验证码」的定位很明确:它是短信的补充渠道,用来解决短信到达延迟、被拦截、被诈骗分子利用等问题。语音验证码的到达速度通常快于短信——这是它在 OTP 场景里唯一不可替代的价值。
📝 兼容性提醒:官方文档明确写明「目前 Voice Service 的外呼仅支持中文和英文」。如果你的用户群是阿拉伯语、西班牙语、泰语母语者,TTS 模板要么用英文,要么改用预录音频文件(音频文件不受语言限制,但需要自己录制与送审)。
2.2 六条必须先知道的硬边界
这六条是从官方文档与产品页里逐条比对出来的,它们决定了这个服务能不能用在你的场景里,比费率表重要得多:
| # | 硬边界 | 官方口径 |
|---|---|---|
| 1 | 产品仍处于 Beta | 国际站产品页标题即写作 Voice Service (Beta),功能与 SLA 可能仍在演进 |
| 2 | 只在单一地域部署 | 官方原文「Voice Service is deployed in the Singapore region」,API 端点也只有 ap-southeast-1 一个 |
| 3 | 不支持坐席实时全双工通话 | 官方 FAQ 原文:不支持坐席与对方实时全双工沟通,只能「用固定的语音验证码或通知模板拨打指定号码」 |
| 4 | 不支持 SIP 集成(文档口径) | 官方 FAQ 原文 SIP integration is not supported either |
| 5 | 不支持拨打国际长途 | 官方原文:Voice Service currently does not support outbound international calls,包括申请并使用海外 DID 号码拨打 |
| 6 | 外呼仅中英文 + 免费热线仅能呼入 | TTS 外呼限中英文;号码类型选 Toll-free(热线)时仅支持呼入 |
⚠️ 一处官方文档自相矛盾,务必留意:第 4 条(FAQ 写「不支持 SIP 集成」)与产品页宣传的
International SIP Trunking能力、以及官方调价公告里把voice SIP列为受影响服务,三处表述不一致。合理的解释是:SIP 中继是与语音云 API 并列的另一条产品线(自助开通按需线路),而不是VoiceSingleCall/VoiceGroupCall这两个 API 的能力。如果你确实需要 SIP 中继,请以客户经理的答复为准,不要仅凭产品页宣传语下单。
📝 小提示:正因为以上六条,Voice Service 的真实适用场景其实很窄——它最适合做「OTP 验证码 + 系统告警语音通知」这两件事,不适合做呼叫中心、客服热线、真人外呼。把它当"电话版的短信"来理解,预期就不会错位。
三、价格全景(一):DID 月费只有一个价,但只公开了三个国家
语音服务的费用由两块拼成:DID 号码月费(订阅制)+ 通话费(按分钟)。这是它和短信/邮件最不一样的地方——你还没开始发消息,就已经在为"持有号码"付费了。
官方公布的 DID 月费表只有三个国家,而且月费完全相同:
| 国家/地区 | 国家代码 | 号码月费(USD/月) | 计费口径 |
|---|---|---|---|
| 韩国(South Korea) | 82 | 50 | 按整月扣,激活当月即开始计费,不足一个月按整月计 |
| 马来西亚(Malaysia) | 60 | 50 | 同上 |
| 泰国(Thailand) | 66 | 50 | 同上 |
关于月费,官方给了四条必须记住的规则:
- 激活当月即计费,且不足一整月按整月算——月中开通不会给你按比例折算。
- 要停止扣费,必须在控制台 Number Management 页面注销号码,且注销当月仍然收费。
- 合同期内不能注销号码。国际号码是稀缺资源,官方原文:
You cannot unregister a number during its contract period。 - 号码预计开通时间 15 个工作日,接入协议为
SIP over IP,号码类型为双向 PSTN。
🔴 最容易踩的坑:官方文档的费率表覆盖了 17 个国家,但月费表只公开了韩国、马来西亚、泰国三个。也就是说,「有通话费率」不等于「有公开月费」——你想买美国、日本、英国的号码,费率查得到,月费必须联系客户经理询价。做预算时不要拿公开的
$50/月去套所有国家。
四、价格全景(二):17 国通话费率全表,以及用"点数"反推单价的方法
官方把付费的按分钟单价和资源包抵扣点数放在同一张表里,这正是理解这门生意的钥匙。抵扣比例是 1:10,000,也就是:点数 ÷ 10,000 = 美元/分钟。下表按费率从低到高排列:
| 国家/地区 | 代码 | 呼出(USD/分钟) | 呼入(USD/分钟) | 抵扣点数 |
|---|---|---|---|---|
| 巴西 Brazil | BR | 0.0267 | 0.0267 | 267 |
| 韩国 South Korea | KOR | 0.035 | 0.035 | 350 |
| 墨西哥 Mexico | MEX | 0.045 | 0.045 | 450 |
| 中国香港 Hong Kong | HKG | 0.046 | 0.046 | 460 |
| 澳大利亚 Australia | AUS | 0.062 | 0.062 | 620 |
| 马来西亚 Malaysia | MYS | 0.08 | 0.08 | 800 |
| 新西兰 New Zealand | NZL | 0.08 | 0.08 | 800 |
| 美国/加拿大 US/CA | USA | 0.09 | 0.09 | 900 |
| 泰国 Thailand | THA | 0.1 | 0.1 | 1,000 |
| 越南 Vietnam | VNM | 0.12 | 0.12 | 1,200 |
| 印度尼西亚 Indonesia | IDN | 0.1733 | 0.1733 | 1,733 |
| 日本 Japan | JPN | 0.2067 | 0.2067 | 2,067 |
| 土耳其 Türkiye | TUR | 0.228 | 0.228 | 2,280 |
| 菲律宾 Philippines | PHL | 0.2467 | 0.2467 | 2,467 |
| 法国 France | FRA | 0.5 | 0.5 | 5,000 |
| 荷兰 Netherlands | NLD | 0.75 | 0.75 | 7,500 |
| 英国 United Kingdom | GBR | 0.998 | 0.998 | 9,980 |
这张表里有四个不直观的事实,值得单独拎出来:
① 呼入与呼出同价。 官方表里每个国家的 Pay-as-you-go (outbound) 与 Pay-as-you-go (inbound) 数值完全一致,点数也一致。这跟很多运营商的"呼入便宜、呼出贵"惯例相反,意味着买 DID 号码接听来电和主动外呼,成本结构是一样的,不需要为了省呼入费去折腾架构。
② 费率不按"发达程度"排列,欧洲三国是全场最贵。 英国 $0.998/分钟、荷兰 $0.75、法国 $0.5,构成价格前三;而韩国只要 $0.035,是英国的 1/28.5,日本 $0.2067 也只有法国的 2/5。最便宜的是巴西 $0.0267,最高与最低相差 37.4 倍。这说明跨国批量语音的成本几乎完全由目的国运营商决定,与你的技术方案无关——做多国 OTP 业务时,「往哪个国家打」比「怎么打」重要一个数量级。
③ 美加是同一条目。 表中 United States/Canada 合并为一行、同为 $0.09/分钟,做北美业务时不必区分。
④ 反向查询技巧。 官方只给了点数,没给单价时(本表两个都给了),你随时可以用点数 ÷ 10,000 反推单价——例如看到某个新国家的点数是 4,120,就知道单价是 $0.412/分钟。这个换算关系在核对账单时特别有用。
⚠️ 费率是会变的,而且变得很猛。 官方 2025-09-28 发布、2025-11-01 生效的调价公告显示:受运营商结算价调整影响,四个国家的群呼与 SIP 按量费率被上调——
| 国家 | 调整前(USD/分钟) | 调整后(USD/分钟) | 涨幅 |
|---|---|---|---|
| 巴西 Brazil | 0.0260 | 0.0267 | +2.7% |
| 日本 Japan | 0.1500 | 0.2067 | +37.8% |
| 印度尼西亚 Indonesia | 0.0850 | 0.1733 | +103.9% |
| 菲律宾 Philippines | 0.2100 | 0.2467 | +17.5% |
印尼一次性翻倍、日本涨近四成。「价格可能变动,请以官方为准」在语音服务上不是一句套话,而是每年都会发生的事实。 另外注意:公告明确「如果你已与客户经理谈好折扣价,约定价格不受影响」——这恰好说明,大用量客户走商务谈判拿协议价比看公开价目表更重要。
五、核心发现:语音服务的资源包是"零折扣预付",与短信、邮件完全相反
资源包(Resource Plan)在很多阿里云产品里是实打实的省钱工具。但在语音服务上,它不是。 这一节是本文最值得收藏的部分。
官方共提供 5 档 Global 资源包。把「价格 ÷ 点数」算出来,结论一目了然:
| 资源包档位 | 点数 | 价格(USD) | 折算点数单价 |
|---|---|---|---|
| Global 入门档 | 50,000 | 5 | $0.0001/点 |
| Global 小档 | 200,000 | 20 | $0.0001/点 |
| Global 中档 | 1,000,000 | 100 | $0.0001/点 |
| Global 大档 | 10,000,000 | 1,000 | $0.0001/点 |
| Global 顶档 | 100,000,000 | 10,000 | $0.0001/点 |
五档的点数单价完全一致,恒为 $0.0001/点,没有任何阶梯折扣。 把这个单价代回第四节:任何国家的「点数 × $0.0001」都恰好等于它的按量单价。也就是说——
阿里云国际版语音服务的资源包,与按量付费是严格等价关系,对通话费本身提供零折扣。
把三家的触达产品放在一起对比,差异非常刺眼:
| 产品 | 资源包/套餐是否比按量便宜 | 折扣幅度(官方数据) |
|---|---|---|
| 邮件推送 DirectMail | 是 | 100 万封套餐 $230.55,较按量 $290 省 20.5%(官方算例) |
| 短信服务 SMS | 因国而异 | 印度/巴西/印尼等国便宜 52%~66%,泰国反而是按量便宜 20% |
| 语音服务 VMS(本文) | 否 | 0%(严格等价) |
那资源包还有什么用? 官方定义里有一句关键的话:Resource plans cover DID number and call fees——资源包同时覆盖 DID 号码月费和通话费。结合第三、四节的数字可以推出它唯一的经济价值:
以泰国号码、每月 5,000 分钟为例,一年需求 = 60,000 分钟 = 60,000,000 点,买 6 份 10,000,000 点包 = $6,000,恰好等于按量通话费 60,000 × $0.10 = $6,000。但按量方案还要另付 DID 月费 $50 × 12 = $600,年总成本 $6,600;若资源包确实能抵扣月费,则年总成本降为 $6,000,省 9.1%。这 9.1% 就是从 DID 月费里省出来的。
📝 口径说明:官方没有公布 DID 月费的抵扣点数,上文的 9.1% 是基于官方原文「资源包覆盖月费与通话费」做的示意测算,实际抵扣比例请向客户经理确认后再下单。这是「价格可能变动、请以官方为准」的又一个注脚。
资源包还有四条限制必须知道:
| 限制项 | 官方口径 |
|---|---|
| 有效期 | 12 个月,到期即失效 |
| 退款 | 不可退款,未用完也不能退 |
| 欠费时可用性 | 账户存在欠费时资源包不可用 |
| 用尽后 | 需再购一份,或联系客户经理切换回按量 |
结论:如果你追求"省钱",语音服务的正确姿势是先谈协议价(调价公告明确约定价不受公开调价影响),而不是买资源包。买资源包的理由只有两个——锁定预算、以及用点数抵扣 DID 月费。
六、成本测算:DID 月费与通话费,谁才是账单大头?
把第三、四节的数据代进去算一遍。下面这张表以三个已公开月费的国家为例,月费统一 $50,分别测算每月 1,000 / 5,000 / 20,000 分钟三档用量(所有数字均由上表单价直接计算得出,未做近似):
| 国家 | 月用量 | 通话费(USD/月) | DID 月费 | 月合计 | 年合计 | 月费占总成本比 |
|---|---|---|---|---|---|---|
| 韩国($0.035/分) | 1,000 分钟 | 35.00 | 50 | 85.00 | 1,020 | 58.8% |
| 韩国 | 5,000 分钟 | 175.00 | 50 | 225.00 | 2,700 | 22.2% |
| 韩国 | 20,000 分钟 | 700.00 | 50 | 750.00 | 9,000 | 6.7% |
| 马来西亚($0.08/分) | 1,000 分钟 | 80.00 | 50 | 130.00 | 1,560 | 38.5% |
| 马来西亚 | 5,000 分钟 | 400.00 | 50 | 450.00 | 5,400 | 11.1% |
| 马来西亚 | 20,000 分钟 | 1,600.00 | 50 | 1,650.00 | 19,800 | 3.0% |
| 泰国($0.10/分) | 1,000 分钟 | 100.00 | 50 | 150.00 | 1,800 | 33.3% |
| 泰国 | 5,000 分钟 | 500.00 | 50 | 550.00 | 6,600 | 9.1% |
| 泰国 | 20,000 分钟 | 2,000.00 | 50 | 2,050.00 | 24,600 | 2.4% |
这张表藏着三条选型规则:
① 低用量时,你买的其实是"号码",不是"通话"。 韩国号码月打 1,000 分钟时,DID 月费占总成本 58.8%——超过了通话费本身。对月通话量在几千分钟以下的团队来说,DID 月费才是决定要不要用语音服务的第一因素,费率高低反而是次要的。这也解释了为什么官方要把月费设计成"合同期内不可注销"——它是这项服务的主要收入来源。
② 号码选在哪国,决定了费率区间。 同样 20,000 分钟,用韩国号码是 $750/月,换泰国号码就是 $2,050/月,差 2.7 倍。费率跨度最大的两个国家是做批量外呼时最该避开的:英国($0.998)与荷兰($0.75)。
③ 用量越大,月费占比越低、越趋近于纯通话成本。 20,000 分钟档下月费占比降到 2.4%~6.7%,此时优化费率(换国家、谈协议价)的收益远大于优化月费。
七、实操(一):从企业资质到拿到号码的七步
语音服务必须先有企业资质,才能申请号码——这是它和短信最大的流程差别:个人开发者无法开通(需要营业执照与法人身份证)。
7.1 第一步:创建企业资质(约 1 个工作日审核)
- 登录语音服务控制台
vms.console.alibabacloud.com。 - 左侧导航点击 Qualification Management(资质管理)。
- 点击 Create Qualification(创建资质),按下表填写。
| 分组 | 配置项 | 填写要求 |
|---|---|---|
| 企业信息 | Country/Region | 你要申请号码的注册国家/地区 |
| 企业信息 | Full Name | 企业名称,必须与营业执照名称一致 |
| 企业信息 | Enterprise Code | 营业执照上的统一社会信用代码 |
| 企业信息 | Address | 营业执照上的企业地址 |
| 企业信息 | Business License | 上传营业执照原件扫描/照片,或加盖公章的复印件 |
| 企业信息 | Name / ID Card Number of Legal Entity | 法人姓名与身份证号 |
| 企业信息 | ID Card of Legal Entity | 法人身份证正反面照片 |
| 联系信息 | Contact Name / Phone / Email | 申请人联系方式 |
- 点击 Submit Application。审核在 1 个工作日内完成,通过后即可购买号码。
7.2 第二步:申请号码(预审 1 个工作日 + 开通 15 个工作日)
进入 Number Management(号码管理) → Apply for Number(申请号码),填写这张表:
| 分组 | 配置项 | 填写要点与坑 |
|---|---|---|
| 号码信息 | Description / Name | 本次申请的备注名 |
| 号码信息 | Country/Region of Numbers | 号码所属国家/地区 |
| 号码信息 | Number Type | 三选一:Fixed(固话)/ Mobile(手机号)/ Toll-free(热线)。⚠️ 选 Toll-free 时只能呼入 |
| 号码信息 | Number Usage | National Call(全国呼叫)或 Local Call(本地呼叫) |
| 号码信息 | Call Destination Country/Region | 你要拨打的目的国家/地区 |
| 号码信息 | Call Type | Inbound Call(仅呼入)或 Inbound and Outbound Call(双向) |
| 号码信息 | Requested Quantity | 申请数量 |
| 号码信息 | Expected Activation Date | 期望交付日。⚠️ 时区为 UTC+8,且官方要求至少选 15 个工作日之后,否则申请会被自动关闭 |
| 月度预估 | Inbound / Outbound Call | 预估月呼入/呼出通话量 |
| 月度预估 | Estimated Total Concurrency | 预估并发通话数 |
| 月度预估 | Subscription Period | 订阅周期(合同期)——合同期内不可注销号码 |
| 联系信息 | Contact Name / Number | 联系人 |
| 资质文件 | Qualification Document | 选择上一步已通过的资质 |
提交后:预审 1 个工作日内完成;通过后号码在 15 个工作日内开通。官方特别提醒:即便通过预审,也可能因号码库存不足而无法开通,最终开通取决于号码可用性。
🔴 两个时间坑叠加:资质审核 1 天 + 号码预审 1 天 + 号码开通 15 个工作日,全流程最坏情况接近一个月。上线计划一定要把这段前置时间算进去,不要等业务要跑了才去申请号码。
7.3 第三步:创建语音模板(审核 2 小时内)
语音模板就是"接通后播给对方听的内容",有两种类型,二选一:
| 模板类型 | 制作方式 | 格式与限制 | 审核时长 |
|---|---|---|---|
| 音频文件(Audio File) | 自己录制后上传 | 仅支持 WAV 格式,大小上限 10 MB | 通常 2 小时内 |
| TTS 模板 | 控制台填文本,系统合成 | 外呼仅支持中文与英文 | 通常 2 小时内 |
两条路径的控制台入口都在 International Voice Call → Voice Call Template 下(Audio File / TTS Template 两个标签页)。审核时间窗口:每天 09:00–23:00(UTC+8),公众假期除外;被驳回可在 Status 列查看原因。
📝 小提示:模板审核有工作时间窗口,周末与节假日提交会顺延。做活动前请提前 1~2 天把模板备好。
八、实操(二):API 接入五步
8.1 接口基础信息
| 项目 | 值 |
|---|---|
| 产品代号 | Dyvmsapi-intl(VMS 的 OpenAPI 代号) |
| API 版本 | 2021-10-15 |
| 签名风格 | RPC |
| SDK 下载 | api.alibabacloud.com/api-tools/sdk/Dyvmsapi-intl?version=2021-10-15 |
| 公网接入点 | dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| VPC 接入点 | dyvmsapi-intl-vpc.ap-southeast-1.aliyuncs.com |
| 唯一地域 | Singapore(ap-southeast-1) |
8.2 只有两个核心 API
语音服务的 API 目录极简,业务调用只有两个:
| API | 作用 | 关键参数 |
|---|---|---|
VoiceSingleCall | 单呼:向一个号码发送带变量的语音验证码或语音通知 | 被叫号码、语音文件 ID 或 TTS 模板 ID、变量 |
VoiceGroupCall | 群呼:向多个号码批量发送语音通知 | 号码列表、模板 ID、变量 |
8.3 接入五步
第一步,准备 AccessKey。 官方明确建议:不要用主账号 AccessKey,而是创建一个仅有 API 权限的 RAM 用户,按最小权限原则(PoLP)授权,主账号只在必要场景使用。
第二步,把模板 ID 记下来。 第七节创建并通过审核的音频/TTS 模板,会在控制台模板页显示模板 ID——API 调用时传入的就是这个 ID。
第三步,设置外呼变量。 模板中的变量(如验证码、订单号)通过 API 参数传入,这样同一个模板可以复用在所有消息上,不必为每条消息单独审模板。
第四步,写调用代码。 以 Python SDK 为例(示意结构,实际以官方 SDK 文档为准):
// 语音服务单呼示例(Dyvmsapi-intl / 2021-10-15,RPC 签名)
// 注意:中文/英文话术走 TTS 模板;其他语言请改用预录音频文件
from alibabacloud_dyvmsapi_intl20211015.client import Client
from alibabacloud_dyvmsapi_intl20211015 import models as vms_models
from alibabacloud_tea_openapi import models as open_api_models
config = open_api_models.Config(
access_key_id=os.environ["ALIYUN_AK"], # 用 RAM 用户 AK,勿用主账号
access_key_secret=os.environ["ALIYUN_SK"],
)
config.endpoint = "dyvmsapi-intl.ap-southeast-1.aliyuncs.com" # 公网
client = Client(config)
req = vms_models.VoiceSingleCallRequest(
called_number="60123456789", # 被叫号码(含国家码,不带 + 号)
tts_code="TTS_123456789", # 已审核通过的 TTS 模板 ID
called_show_number="6033334444", # 主叫 DID 号码
play_times=2, # 播放次数
)
resp = client.voice_single_call(req)
📝 小提示:生产环境请把 AccessKey 放进环境变量或密钥管理服务(KMS),不要硬编码进代码仓库——这属于最基础的安全纪律。
第五步,验证与排障。 先用单个自己的号码跑通 VoiceSingleCall,确认接通、播报、变量替换都正常,再放量跑 VoiceGroupCall。不要跳过单点验证直接群呼——群呼是计费的,一次参数写错就是一批无效通话。
⚠️ 如果 SDK 不满足你的场景:官方说明自签名(self-signing)集成细节复杂,大约需要 5 个工作日,并建议加入钉钉服务群
147535001692在专家指导下进行。不要自己硬啃签名算法。
九、选型:什么时候该用语音,什么时候该用短信?
语音与短信不是替代关系,而是互补关系。官方文档自己就写得很清楚:语音通知是「短信的补充」,用来防止送达延迟。下面这张决策表可以帮你直接判断:
| 你的场景 | 推荐通道 | 理由 |
|---|---|---|
| 金融交易、账号安全等高危 OTP | 语音优先,短信兜底 | 语音验证码到达快、抗短信拦截与 SIM 劫持,官方定位即"防止刷单等欺诈" |
| 系统告警、故障通知(值班人员) | 语音优先 | 短信可能沉睡在通知栏,电话会直接把人叫醒 |
| 订单提醒、物流通知、退款提醒 | 短信优先,语音兜底 | 短信成本低、可留存、不打扰;送达失败再触发语音 |
| 批量营销、广告推广 | 看国家选 | 语音群呼成本高(英国最高 $0.998/分钟),邮箱/短信更划算 |
| 企业官网咨询热线 | DID 号码 | 这是 DID 的典型场景,与短信无关 |
| 真人坐席客服 | 不用 VMS | 官方不支持坐席全双工通话,需 SIP 中继或自建呼叫中心 |
再看一张语音验证码 vs 短信验证码的直接对比,这两条通道的成本口径完全不同:
| 对比维度 | 语音验证码(VMS) | 短信验证码(SMS) |
|---|---|---|
| 计费单位 | 按分钟(不足 1 分钟按 1 分钟) | 按条 |
| 前置成本 | 有:DID 号码月费 $50/月起 | 无:按量模式无月费 |
| 语言限制 | TTS 仅中英文(音频文件不受限) | 基本无限制 |
| 到达速度 | 更快(需接听) | 快(但可能延迟/被拦) |
| 抗拦截 | 强 | 弱(可被运营商/手机管家拦截) |
| 适合场景 | 高危 OTP、值班告警 | 常规 OTP、通知、营销 |
📝 一句话结论:如果月通话量低于几千分钟,语音验证码的"每条成本"一定高于短信——因为 DID 月费摊不薄(见第六节,韩国 1,000 分钟档月费占比 58.8%)。语音真正的价值是可达性与安全性,不是省钱。用语音的理由应该是"短信到不了"或"短信不够安全",而不是"语音更便宜"。
十、常见坑(八条速查)
| # | 坑 | 后果 | 处置 |
|---|---|---|---|
| 1 | 把资源包当成省钱手段 | 付费与按量严格等价,白占资金 | 想省钱去谈协议价;资源包只用于锁预算与抵扣月费 |
| 2 | 用公开的 $50/月 给所有国家做预算 | 只有韩/马/泰公开月费,其余国家需询价 | 未公布国家的月费必须问客户经理 |
| 3 | 期望激活日选得太近 | 距今天不足 15 个工作日,申请被自动关闭 | 时区按 UTC+8,至少往后留 15 个工作日 |
| 4 | 以为合同期内可以退号 | 官方明确合同期内不可注销,注销当月仍收费 | 号码数量按长期规划申请,别按活动峰值申请 |
| 5 | 月中开号想按比例付月费 | 不足一个月按整月计费 | 月底开号与月初开号同价 |
| 6 | 忘记号码库存限制 | 预审通过也可能开不出号 | 提前申请、预留备选国家 |
| 7 | 模板审核卡在非工作时间 | 审核窗口仅 09:00–23:00(UTC+8) | 活动前 1~2 天备好模板 |
| 8 | 主账号 AccessKey 直接调用 API | AK 泄露将危及账号全部资源 | 建 RAM 用户,最小权限(PoLP),AK 放环境变量或 KMS |
📝 两条流程坑也值得记:① 全流程最坏接近一个月(资质 1 天 + 预审 1 天 + 开通 15 个工作日),上线排期必须前置;② 语音服务要求企业资质,需要营业执照与法人身份证正反面,个人主体无法开通。
十一、常见问题 FAQ
- Q: 语音服务支持真人坐席与客户实时双向通话吗?
A: 不支持。官方 FAQ 明确:不支持坐席实时全双工沟通,也不支持 SIP 集成,只能用固定的语音验证码或通知模板拨打指定号码。需要坐席通话请走 SIP 中继或自建呼叫中心。
- Q: 一个号码的月费是多少?所有国家都一样吗?
A: 官方只公开了韩国、马来西亚、泰国三国的月费,且都是 $50/月。其余国家的月费未公开,需联系客户经理询价。
- Q: 资源包比按量付费便宜吗?
A: 不便宜。五档 Global 资源包的点数单价恒为 $0.0001/点,折算后与各国按量单价严格相等,折扣为 0。资源包的唯一价值是抵扣 DID 月费与锁定预算。
- Q: 资源包有效期多久?用不完能退吗?
A: 有效期 12 个月,到期即失效;官方明确不可退款,未用完也无法退;账户欠费时资源包不可用。
- Q: 呼入和呼出价格一样吗?
A: 一样。官方表中每个国家的呼入与呼出单价、抵扣点数完全一致。
- Q: 哪个国家的语音费率最贵?哪个最便宜?
A: 最贵是英国 $0.998/分钟,其次是荷兰 $0.75、法国 $0.5;最便宜是巴西 $0.0267/分钟,其次是韩国 $0.035。最高与最低相差约 37 倍。
- Q: 语音验证码比短信验证码便宜吗?
A: 不一定,通常更贵。语音按分钟计费且需要 DID 号码月费,短信按条计费且按量模式无月费。语音的优势在到达速度与抗拦截,而不是价格。
- Q: 外呼支持哪些语言?
A: TTS 模板的外呼只支持中文和英文。其他语言需改用预录音频文件(WAV 格式、≤10 MB)。
- Q: 号码开通要多久?
A: 资质审核 1 个工作日、号码预审 1 个工作日、号码开通 15 个工作日,全流程最坏接近一个月。且预审通过后仍可能因库存不足无法开通。
- Q: 模板审核要多久?
A: 音频文件与 TTS 模板通常 2 小时内完成审核,但审核服务仅在工作日 09:00–23:00(UTC+8) 提供,公众假期不审。
- Q: API 怎么接入?端点是什么?
A: 产品代号 Dyvmsapi-intl,版本 2021-10-15,RPC 签名。公网端点 dyvmsapi-intl.ap-southeast-1.aliyuncs.com,VPC 端点 dyvmsapi-intl-vpc.ap-southeast-1.aliyuncs.com,仅新加坡地域。核心 API 只有 VoiceSingleCall(单呼)与 VoiceGroupCall(群呼)两个。
- Q: 语音服务目前是正式版吗?
A: 国际站产品页标注为 Voice Service (Beta),且仅在 Singapore 地域部署。上线前建议先做小流量验证,并向客户经理确认当前能力边界。
十二、总结
把全文结论压缩成五句话:
- 语音服务(VMS)是"触达层"的第三条腿,定位是短信的补充通道,最适合高危 OTP 验证码与值班告警语音通知,不适合坐席客服与营销群发。
- 它有六条硬边界:Beta、仅新加坡地域、不支持坐席全双工、文档口径不支持 SIP 集成、不支持拨打国际长途、TTS 外呼仅中英文。用之前先对着这六条自查。
- 成本是"月费 + 分钟费"两块:DID 月费公开价
$50/月(仅韩/马/泰三国),通话费率 17 国相差最大 37 倍(巴西 $0.0267 ~ 英国 $0.998)。低用量时月费才是账单大头(韩国 1,000 分钟档占 58.8%)。 - 资源包是零折扣预付:点数恒为
$0.0001/点,与按量严格等价——这与短信、邮件推送的资源包折扣形成鲜明对照。省钱的正确姿势是谈协议价。 - 流程比技术更容易翻车:企业资质 1 天 + 号码预审 1 天 + 号码开通 15 个工作日,加上合同期内不可注销、不足整月按整月计费,排期与号码数量规划必须前置。
如果你的业务正在做海外 OTP,建议把本站三篇连读:先用 注册教程 把国际版账号开好,再用 短信服务 SMS 篇 搭好主通道,最后用本文的语音服务做兜底通道;告警联动可以配合 云监控 CloudMonitor 篇。
⚠️ 免责声明:本文中提到的配置、价格和优惠信息可能随时间变化,请以阿里云国际版官网(alibabacloud.com)的实时信息为准。本文不构成任何投资或购买建议。注册前请确认当地法规合规性。
本文由 2.chengzicloud.cloud 提供,点击访问首页了解更多