## 一、接口描述

本接口支持向俄罗斯手机、俄罗斯固话发起语音通知呼叫，支持两种播报模式：直接提交俄语文本实时播报、使用报备模板 + 变量填充播报。

- 鉴权模式：固定 APIKEY 鉴权、动态 MD5 密码鉴权

- 单次呼叫：仅支持单个俄罗斯号码提交

- 号码格式规范：国家区号 + 空格 + 号码，俄罗斯区号为 7，示例：`7 9123456789`

- 返回格式：JSON / XML，自动识别接收类型


## 二、请求头说明


表格

|参数名称|参数固定值|类型|必填|
|:-:|:-:|:-:|:-:|
|Content-Type|application/x-www-form-urlencoded|string|是|
## 三、请求参数说明


表格

|参数名称|参数说明|示例|类型|必填|
|:-:|:-:|:-:|:-:|:-:|
|account|APIID获取路径：用户中心【云语音】-【国际语音通知】-【产品总览】|12345678|string|是|||
|password|鉴权密码二选一：1. 固定鉴权：APIKEY（产品总览查看）2. 动态鉴权：MD5 加密动态密码（文末提供加密代码）|abcdef123456|string|是|||
|mobile|俄罗斯接收号码，单次仅传 1 个；格式规范：国家区号 + 空格 + 手机号|7 9123456789|string|是|||
|content|语音播报内容，两种使用模式：1. 完整播报模式：直接填写俄语播报文本2. 模板变量模式：多变量使用英文竖线 `|` 分隔|Ваш заказ из России отправлен, номер накладной HK20260731HK20260731|СФ Международный|180 долларов США|string|否|
|templateid|国际语音模板 ID，使用模板变量播报时必填调试测试模板 ID：2361默认测试模板内容：您的海外订单号：【变量】，承运商：【变量】，金额：【变量】，请注意接听|2361|int|否|||
|time|10 位 Unix 时间戳仅使用**动态密码鉴权**时必填|1754064000|string|动态鉴权必填|||
>重要提示：俄语播报文本需要提前向运营商报备，未经报备直接提交完整 content 播报会返回 4077 报错；模板模式下，变量数量、变量长度必须和后台报备模板保持一致。

## 四、响应返回参数


表格

|参数名称|参数说明|成功示例|类型|是否必返回|
|:-:|:-:|:-:|:-:|:-:|
|code|业务状态码，2 = 提交成功|2 / 1|int|是|
|msg|提交结果文字描述|提交成功 / 手机号格式错误|string|是|
|ivmid|语音呼叫唯一流水号；失败返回 0 或空字符串|17540640009876|string|提交成功返回|
## 五、响应状态码对照表


表格

|code|msg提示|问题说明|
|:-:|:-:|:-:|
|0|提交失败|通用未知提交异常|
|2|提交成功|呼叫任务已受理排队|
|400|非法 ip 访问|服务器出口 IP 未备案 / 未添加白名单|
|401|帐号不能为空|account 参数缺失|
|402|密码不能为空|password 参数缺失|
|403|手机号码不能为空|mobile 参数为空|
|4030|手机号码已被列入黑名单|该俄罗斯号码限制外呼|
|404|语音内容不能为空|未传 content 且未传合法 templateid|
|405|用户名或密码不正确|account/APIKEY 不匹配|
|4050|账号被冻结|账户欠费 / 违规冻结，联系客服|
|40505|没有签定合同|未开通国际语音业务权限|
|4051|剩余条数不足|国际语音余额不足|
|4052|访问 ip 与备案 ip 不符|服务器出口 IP 和后台备案不一致|
|406|手机格式不正确|俄罗斯号码缺少国家区号、格式不规范|
|407|语音内容含有敏感字符|播报文本包含违规敏感词|
|4071|没有提交备案模板|使用 templateid 但模板未报备审核|
|4072|提交的语音内容必须与报备过的模板格式相匹配|传入变量数量与备案模板变量数量不一致|
|40722|变量内容超过指定的长度|单个变量文本超出模板限制字数|
|4077|播报内容未在运营商报备|完整文本播报模式未提前报备俄语文案|
|408|您的帐户疑被恶意利用，已被自动冻结，如有疑问请与客服联系。|风控检测异常自动冻结账号|
|4080|同一手机号码同一秒钟之内发送频率不能超过 1 条|单号码每秒呼叫上限 1 次|
|4081|同一手机号一分钟之内发送超过 3 条|单号码每分钟呼叫上限 3 次|
|4082|超出同一手机号一天之内 10 条语音限制|单号码单日最大呼叫 10 次|
|4086|提交失败|接口服务内部异常，稍后重试|
## 六、GET 请求完整调用示例

### 俄语文本直传模式 GET 示例

```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=7 9123456789&content=Ваш заказ из России отправлен, номер накладной HK20260731
```### 模板变量模式 GET 示例

```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=7 9123456789&templateid=2361&content=HK20260731|СФ Международный|180 долларов США
```### 动态密码鉴权 GET 示例（带 time 时间戳）

```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=md5加密后字符串&mobile=7 9123456789&templateid=2361&content=HK20260731|СФ Международный|180 долларов США&time=1754064000
```## 七、接口返回响应示例

### 1. 成功返回 JSON

```
{
  "code": 2,
  "msg": "提交成功",
  "ivmid": "17540640009876"
}
```### 2. 成功返回 XML

```
<?xml version="1.0" encoding="utf-8"?>
<SubmitResult>
  <code>2</code>
  <msg>提交成功</msg>
  <ivmid>17540640009876</ivmid>
</SubmitResult>
```### 3. 失败返回 JSON

```
{
  "code": 406,
  "msg": "手机格式不正确"
}
```### 4. 失败返回 XML

```
<?xml version="1.0" encoding="utf-8"?>
<SubmitResult>
  <code>406</code>
  <msg>手机格式不正确</msg>
</SubmitResult>
```## 八、PHP 动态密码 MD5 加密代码示例

动态密码加密规则：`md5(account + 原始APIKEY + mobile + content + time)`
所有拼接内容必须统一 UTF-8 编码后加密
```
<?php
$account = '12345678';
$apikey = 'abcdef123456';
$mobile = '7 9123456789';
$content = 'HK20260731|СФ Международный|180 долларов США';
$time = '1754064000';
// 拼接明文
$originStr = $account . $apikey . $mobile . $content . $time;
// 生成动态密码
$password = md5($originStr);
// 最终请求参数 $password 传入加密后字符串
?>
```## 九、多语言代码示例目录


- Java

- PHP

- Python

- C

- C++

- C#

- Go

- Shell

- Ruby

- Node.js

- Objective-C


## 十、接入注意事项


1. 俄罗斯号码格式务必是 `7 手机号`，区号和号码中间带空格，格式错误直接返回 406；

2. 俄语播报文案需要提前报备审核，适合长期稳定使用的业务提前申请模板；

3. 风控频率限制：单俄罗斯号码每秒最多 1 通、每分钟最多 3 通、每日上限 10 通；

4. 服务器出口 IP 需要在后台备案，更换服务器 IP 后要同步更新白名单，否则 400、4052 报错；

5. 动态鉴权方式时间戳为 10 位 Unix 时间戳，服务端会校验时间，时间偏差过大鉴权失败；

6. 支持 POST 表单提交，生产环境推荐 POST 方式，参数和 GET 保持一致。

本接口支持向俄罗斯手机、俄罗斯固话发起语音通知呼叫，支持两种播报模式：直接提交俄语文本实时播报、使用报备模板 + 变量填充播报。

俄罗斯语音通知接口怎么接入？俄语自动化语音播报 API 调用说明

国际语音通知 API 支持俄罗斯地区号码外呼，可实现俄语自动化语音播报，适合订单通知、验证码通知、还款提醒、物流通知、会议通知等海外业务场景。接口兼容 GET、POST 提交方式，UTF-8 编码，7×24 小时稳定可用，支持固定 APIKEY 鉴权与动态 MD5 密码鉴权两种安全方案，单次支持提交单个俄罗斯号码呼叫，响应自动适配 JSON、XML 格式。

音视频

后端

网络与通信

俄罗斯国际语音通知API支持手机及固话呼叫，提供俄语文本直传和模板变量两种播报模式，兼容固定APIKEY和动态MD5双重鉴权，返回JSON/XML格式数据。号码格式为7+号码，含严格频控机制，单号码每日限呼10次。具备完整错误码体系，涵盖余额不足、IP白名单、模板未报备等场景，提供多语言代码示例，适合跨境电商及海外业务语音验证场景。

代码解释

Objective-C

服务器

JSON

Unix

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

俄罗斯国际语音通知API支持手机及固话呼叫，提供俄语文本直传和模板变量两种播报模式，兼容固定APIKEY和动态MD5双重鉴权，返回JSON/XML格式数据。号码格式为7+号码，含严格频控机制，单号码每日限呼10次。具备完整错误码体系，涵盖余额不足、IP白名单、模板未报备等场景，提供多语言代码示例，适合跨境电商及海外业务...

俄罗斯语音通知接口怎么接入？俄语自动化语音播报 API 调用说明-腾讯云开发者社区-腾讯云

俄罗斯语音通知接口怎么接入？俄语自动化语音播报 API 调用说明

俄罗斯语音通知接口怎么接入？俄语自动化语音播报 API 调用说明

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐