Send TTS Voice Message

POST

https://api.itniotech.com/voice/sendCode

Send a TTS voice message in the specified language and specified language text. When the number of recalls is set to be greater than 0, the call failure recall function will be enabled. At this time, only the last call result will be pushed when the report is pushed.

Request Parameters

callee

String

Required

Called number: 7-15 digits composed of national code + mobile phone number.

displayNum

String

Display number: 7-15 digits or null.

language

String

Required

Language code, please refer to the table below for language details

speakingRate

Double

Speech speed: 0.25 - 4 times

ssmlGender

Int

Voice: 1 male 2 female. Allowed to be empty. When there are multiple voices, the system uses female voice by default.

accent

String

Accent: You can configure language accents, such as English [American Accent], English [Indian Accent], etc. For accent details, please refer to the table below.

text

String

Required

Text content, length 1000

appId

String

Required

Audio application ID

loopCount

Int

Time of loop count: 1-9, by default: 1. Null is allowed.

calledInfo

String

Called information, 0-1000 characters.

recallCount

Int

Recall times, 0-9 numbers, the field can be left blank. if not filled in, the default value is 0, and the recall function is not enabled when it is equal to 0.

recallInterval

Int

Recall interval, 1-999 numbers, in minutes. This field is only valid when the number of recalls is greater than 0. The field can be empty. When the field is empty, the default value is 5.

maxDuration

Int

Maximum call duration, forced hang up after N seconds after the call is connected, 1-120 numbers, can be empty.

maxRingingTime

Int

The maximum ringing duration is 60 by default and can be entered in the range of 20 to 120 seconds.

Request Sample

Request URL:
    https://api.itniotech.com/voice/sendCode
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "callee":"932111111111",
    "displayNum":"1008122211",
    "language":"EN",
    "accent":"91",
    "ssmlGender":2,
    "speakingRate":1,
    "text":"hello world",
    "appId":"4luaKsL2",
    "loopCount":2,
    "calledInfo":"calledInfo",
    "recallCount":0,
    "recallInterval":0,
    "maxDuration":120,
    "maxRingingTime":60
}

Response Parameters

Parameters	Description	Type
status	"0"means successful, others than 0 means failure, seeing Status Code description.	String
reason	Failure reason description	String
data	Exclusive recording ID	String

Response Status Code

status	Description
0	success
-1	Authentication error
-2	Restricted IP access
-10	The customer's balance is insufficient
-16	Timestamp expires
-18	Port program unusual
-22	Parameter exception
-26	Getting fee faily

Language, Accent and Timbre Relationship Table

Language	Accent	Timbre
Arabic (AR)	-	Male Voice: 1 Female Voice: 2
Bask (BAS)	Spain (34)	Male Voice:- Female Voice: 2
Catalan (CA)		Male Voice:- Female Voice: 2
Galician (GL)		Male Voice:- Female Voice: 2
Bengali (BN)	India (91)	Male Voice: 1 Female Voice: 2
Gujarati (GU)		Male Voice: 1 Female Voice: 2
Hindi (HI)		Male Voice: 1 Female Voice: 2
Kannada (KN)		Male Voice: 1 Female Voice: 2
Malayalam (ML)		Male Voice: 1 Female Voice: 2
Marathi (MR)		Male Voice: 1 Female Voice: 2
Punjabi (PA)		Male Voice: 1 Female Voice: 2
Tamil (TA)		Male Voice: 1 Female Voice: 2
Bulgarian (BG)	Bulgaria (359)	Male Voice:- Female Voice: 2
Czech (CS)	Czech Republic (420)	Male Voice:- Female Voice: 2
Danish (DA)	Denmark (45)	Male Voice: 1 Female Voice: 2
Dutch (NL)	Netherlands (31) [default accent]	Male Voice: 1 Female Voice: 2
Dutch (NL)	Belgium (32)	Male Voice: 1 Female Voice: 2
English (EN)	India (91)	Male Voice: 1 Female Voice: 2
	US (1) [Default Accent]	Male Voice: 1 Female Voice: 2
	United Kingdom (44)	Male Voice: 1 Female Voice: 2
	Australia (61)	Male Voice: 1 Female Voice: 2
Filipino (TL)	Philippines (63)	Male Voice: 1 Female Voice: 2
Finnish (FI)	Finland (358)	Male Voice:- Female Voice: 2
French (FR)	French (33) [default accent]	Male Voice: 1 Female Voice: 2
French (FR)	Canada (1)	Male Voice: 1 Female Voice: 2
German (DE)	Germany (49)	Male Voice: 1 Female Voice: 2
Greek (EL)	Greece (30)	Male Voice:- Female Voice: 2
Hebrew (HE)	Israel (972)	Male Voice: 1 Female Voice: 2
Hungarian (HU)	Hungary (36)	Male Voice:- Female Voice: 2
Icelandic (IS)	Iceland (354)	Male Voice:- Female Voice: 2
Indonesian (ID)	Indonesia (62)	Male Voice: 1 Female Voice: 2
Italian (IT)	Italy (39)	Male Voice: 1 Female Voice: 2
Japanese (JA)	Japan (81)	Male Voice: 1 Female Voice: 2
Korean (KO)	South Korea (82)	Male Voice: 1 Female Voice: 2
Latvian (LV)	Latvia (371)	Male Voice: 1 Female Voice:-
Lithuanian (LT)	Lithuania (370)	Male Voice: 1 Female Voice:-
Malay (MS)	Malaysia (60)	Male Voice: 1 Female Voice: 2
Norwegian (NO)	Norway (47)	Male Voice: 1 Female Voice: 2
Polish (PL)	Poland (48)	Male Voice: 1 Female Voice: 2
Portuguese (PT)	Brazil (55)	Male Voice: 1 Female Voice: 2
Portuguese (PT)	Portugal (351) [default accent]	Male Voice: 1 Female Voice: 2
Romanian (RO)	Romania (40)	Male Voice:- Female Voice: 2
Russian (RU)	Russia (7)	Male Voice: 1 Female Voice: 2
Serbian (RS)	Serbia (381)	Male Voice:- Female Voice: 2
Slovak (SK)	Slovakia (421)	Male Voice:- Female Voice: 2
Spanish (ES)	Spain (34) [Default accent]	Male Voice: 1 Female Voice: 2
Spanish (ES)	United States (1)	Male Voice: 1 Female Voice: 2
Swedish (SV)	Sweden (46)	Male Voice: 1 Female Voice: 2
Thai (TH)	Thailand (66)	Male Voice:- Female Voice: 2
Turkish (TR)	Turkey (90)	Male Voice: 1 Female Voice: 2
Vietnamese (VI)	Vietnam (84)	Male Voice: 1 Female Voice: 2
Afrikaans (AF)	South Africa (27)	Male Voice:- Female Voice: 2

Send File Voice Message

Invoke Phone

Feedback

Was this page helpful?

language

Java

PHP

REQUEST

import cn.hutool.core.codec.Base64;
import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.Header;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.time.LocalDateTime;
import java.time.ZoneId;

public void sendCode() {
    final String baseUrl = "https://api.itniotech.com/voice";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";
    final String appId = "{{appId}}";
    final String callee = "{{callee}}";
    final String displayNum = "{{displayNum}}";
    final String language = "{{language}}";
    final double speakingRate = "{{speakingRate}}";
    final Integer ssmlGender = "{{ssmlGender}}";
    final String accent = "{{accent}}";
    final String text = "{{text}}";
    final Integer loopCount = "{{loopCount}}";
    final String calledInfo = "{{calledInfo}}";
    final Integer recallCount = "{{recallCount}}";
    final Integer recallInterval = "{{recallInterval}}";
    final Integer maxDuration = "{{maxDuration}}";
    final Integer maxRingingTime = "{{maxRingingTime}}";

    final String url = baseUrl.concat("/sendCode");
    HttpRequest request = HttpRequest.post(url);

    // generate md5 key
    final String datetime = String.valueOf(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant().getEpochSecond());
    final String sign = SecureUtil.md5(apiKey.concat(apiPwd).concat(datetime));

    request.header(Header.CONTENT_TYPE, "application/json;charset=UTF-8")
            .header("Sign", sign)
            .header("Timestamp", datetime)
            .header("Api-Key", apiKey);

    final String body = JSONUtil.createObj()
            .set("callee", callee)
            .set("displayNum", displayNum)
            .set("language", language)
            .set("speakingRate", speakingRate)
            .set("ssmlGender", ssmlGender)
            .set("accent", accent)
            .set("text", text)
            .set("appId", appId)
            .set("loopCount", loopCount)
            .set("calledInfo", calledInfo)
            .set("recallCount", recallCount)
            .set("recallInterval", recallInterval)
            .set("maxDuration", maxDuration)
            .set("maxRingingTime", maxRingingTime)
            .toString();

    HttpResponse response = request.body(body).execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }
}

REQUEST

header('content-type:text/html;charset=utf8');

$apiKey = "your api key";
$apiSecret = "your api secret";
$appId = "{{appId}}";
$url = "https://api.itniotech.com/voice/sendCode";
$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);

$dataArr['callee'] = "{{callee}}";
$dataArr['displayNum'] = "{{displayNum}}";
$dataArr['language'] = "{{language}}";
$dataArr['appId'] = $appId;
$dataArr['speakingRate'] = "{{speakingRate}}";
$dataArr['ssmlGender'] = "{{ssmlGender}}";
$dataArr['accent'] = "{{accent}}";
$dataArr['text'] = "{{text}}";
$dataArr['loopCount'] = "{{loopCount}}";
$dataArr['calledInfo'] = "{{calledInfo}}";
$dataArr['recallCount'] = "{{recallCount}}";
$dataArr['recallInterval'] = "{{recallInterval}}";
$dataArr['maxDuration'] = "{{maxDuration}}";
$dataArr['maxRingingTime'] = "{{maxRingingTime}}";

$data = json_encode($dataArr);
$headers = array('Content-Type:application/json;charset=UTF-8',"Sign:$sign","Timestamp:$timeStamp","Api-Key:$apiKey");

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 600);
curl_setopt($ch, CURLOPT_HTTPHEADER,$headers);
curl_setopt($ch, CURLOPT_POSTFIELDS , $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$output = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);

var_dump($output);

RESPONSEEXAMPLE

{
    "status": "0",
    "reason": "success",
    "data": "2203031113381000002"
}

SMS

VOICE

By Industry

By Scenario

Send TTS Voice Message

language