發送TTS語音消息

POST

https://api.laaffic.com/v3/voice/sendCode

通過指定語言和指定語言文本發送TTS語音消息。
 
請求參數
callee
String
必填
被叫號碼,國碼+手機號組成的7-15位數位。
displayNum
String
顯示號碼,7-15位數字,允許為空
language
String
必填
語種, 語種詳細內容請查詢下方表格
speakingRate
Double
語速: 0.25 - 4倍
ssmlGender
Int
音色:1男 2女。 允許為空,存在多種音色時系統默認使用女聲
accent
String
口音,可配置語種口音,如英語[美國口音]、英語[印度口音]等, 口音詳細內容請查詢下方表格
text
String
必填
文本內容,長度1000
appId
String
必填
語音應用id
loopCount
Int
必填
迴圈播報次數,1-9數字,預設為1,允許為空。
recallCount
Int
重呼次數,0-9數字,允許字段為空,不填默認0,等於0時不開啟重呼功能。
recallInterval
Int
重呼間隔,1-999數字,單位分鐘。只在重呼次數大於0時字段才生效,允許字段為空,當字段為空時默認為5。
maxDuration
Int
最長通話時長,接通後N秒強制掛斷,1-120數字,允許為空。
maxRingingTime
Int
最大響鈴時長,預設60,可輸入20-120秒。
calledInfo
String
被叫資訊,0-1000位字符
 
請求示例
Request URL:
    https://api.laaffic.com/v3/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,
    "recallCount":0,
    "recallInterval":0,
    "maxDuration":120,
    "maxRingingTime":60,
    "calledInfo":"calledInfo"
}
 
響應參數
參數 説明 類型
status 狀態碼,0表示成功,其他均爲失敗,詳見狀態碼説明. String
reason 失敗原因説明 String
data 記錄唯一id String
 
響應狀態碼
狀態碼 説明
0 成功
-1 帳號認證異常
-2 IP訪問受限
-10 客戶餘額不足,不滿足本次發送
-16 超出時間限制
-18 系統異常
-22 參數異常
-26 獲取費用失敗
 
語種、口音和音色關係表
語種 口音 音色
阿拉伯語(AR) - 男聲:1;女聲:2
巴斯克語(BAS) 西班牙(34) 男聲:-;女聲:2
加泰羅尼亞語(CA) 男聲:-;女聲:2
加利西亞語(GL) 男聲:-;女聲:2
孟加拉語(BN) 印度(91) 男聲:1;女聲:2
古吉拉特語(GU) 男聲:1;女聲:2
印地語(HI) 男聲:1;女聲:2
卡納達語(KN) 男聲:1;女聲:2
馬拉雅拉姆語(ML) 男聲:1;女聲:2
馬拉地語(MR) 男聲:1;女聲:2
旁遮普語(PA) 男聲:1;女聲:2
泰米爾語(TA) 男聲:1;女聲:2
保加利亞語(BG) 保加利亞(359) 男聲:-;女聲:2
捷克語(CS) 捷克(420) 男聲:-;女聲:2
丹麥語(DA) 丹麥(45) 男聲:1;女聲:2
荷蘭語(NL) 荷蘭(31)【默認口音】 男聲:1;女聲:2
比利時(32) 男聲:1;女聲:2
英語(EN) 印度(91) 男聲:1;女聲:2
美國(1)【默認口音】 男聲:1;女聲:2
英國(44) 男聲:1;女聲:2
澳大利亞(61) 男聲:1;女聲:2
菲律賓語(TL) 菲律賓(63) 男聲:1;女聲:2
芬蘭語(FI) 芬蘭(358) 男聲:-;女聲:2
法語(FR) 法國(33)【默認口音】 男聲:1;女聲:2
加拿大(1) 男聲:1;女聲:2
德語(DE) 德國(49) 男聲:1;女聲:2
希臘語(EL) 希臘(30) 男聲:-;女聲:2
希伯來語(HE) 以色列(972) 男聲:1;女聲:2
匈牙利語(HU) 匈牙利(36) 男聲:-;女聲:2
冰島語(IS) 冰島(354) 男聲:-;女聲:2
印度尼西亞語(ID) 印度尼西亞(62) 男聲:1;女聲:2
意大利語(IT) 意大利(39) 男聲:1;女聲:2
日語(JA) 日本(81) 男聲:1;女聲:2
韓語(KO) 韓國(82) 男聲:1;女聲:2
拉脫維亞語(LV) 拉脫維亞(371) 男聲:1;女聲:-
立陶宛語(LT) 立陶宛(370) 男聲:1;女聲:-
馬來語(MS) 馬來西亞(60) 男聲:1;女聲:2
挪威語(NO) 挪威(47) 男聲:1;女聲:2
波蘭語(PL) 波蘭(48) 男聲:1;女聲:2
葡萄牙語(PT) 巴西(55) 男聲:1;女聲:2
葡萄牙(351)【默認口音】 男聲:1;女聲:2
羅馬尼亞語(RO) 羅馬尼亞(40) 男聲:-;女聲:2
俄語(RU) 俄羅斯(7) 男聲:1;女聲:2
塞爾維亞語(RS) 塞爾維亞(381) 男聲:-;女聲:2
斯洛伐克語(SK) 斯洛伐克(421) 男聲:-;女聲:2
西班牙語(ES) 西班牙(34)【默認口音】 男聲:1;女聲:2
美國(1) 男聲:1;女聲:2
瑞典語(SV) 瑞典(46) 男聲:1;女聲:2
泰語(TH) 泰國(66) 男聲:-;女聲:2
土耳其語(TR) 土耳其(90) 男聲:1;女聲:2
越南語(VI) 越南(84) 男聲:1;女聲:2
南非荷蘭語(AF) 南非(27) 男聲:-;女聲:2
 

語言

Java

PHP

請求

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.laaffic.com/v3/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 Integer recallCount = "{{recallCount}}";
    final Integer recallInterval = "{{recallInterval}}";
    final Integer maxDuration = "{{maxDuration}}";
    final Integer maxRingingTime = "{{maxRingingTime}}";
    final String calledInfo = "{{calledInfo}}";

    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("recallCount", recallCount)
            .set("recallInterval", recallInterval)
            .set("maxDuration", maxDuration)
            .set("maxRingingTime", maxRingingTime)
            .set("calledInfo", calledInfo)
            .toString();

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

請求

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

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

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

$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);        
                
 

響應示例

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

Telegram
WhatsApp
諮詢

點擊此處開啟人工服務