鍵.png)
使用NestJS和Prisma構(gòu)建REST API：身份驗證
1.左側(cè)菜單欄點擊進入我的應(yīng)用然后點擊創(chuàng)建應(yīng)用
2.在彈窗中填好信息點擊提交
3.保存生成的APPKEY
HTTP Method: 支持POST請求
調(diào)用參數(shù)及說明：
| 字段名 | 必填 | 類型 | 描述 |
|---|---|---|---|
| text | 是 | String | 要合成的文本內(nèi)容，限制為1000字符。支持ssml標記語言，使用說明見附錄3。 |
| appkey | 是 | String | 開發(fā)者在AI開放平臺上申請的appkey。 |
| signature | 是 | String | 簽名，通過“appkey+secret+timestamp”進行md5加密，得到的32位MD5值。其中加號也參與MD5的計算。 每次請求實時計算簽名，簽名有效期為10分鐘。 |
| timestamp | 是 | Long | 當(dāng)前時間戳，單位為秒。 |
| speaker | 否 | String | 合成音頻指定發(fā)音人 默認值：cissy_meet 其他發(fā)音人傳值及計費價格請參考聲音商店。pro發(fā)音人合成時長相對較長，慎重選用 |
| audio_type | 否 | String | 合成音頻的格式 默認值：mp3 可選值：pcm/mp3/speex-wb-10/wav 只支持這四種格式中的一種 |
| speed | 否 | Float | 發(fā)音人合成的語速，支持小數(shù)點后兩位 默認值：1.0 可選值：0.5-2.0 |
| convert | 否 | String | 默認值：無 可選值：robot 是否轉(zhuǎn)化為機器聲 |
| rate | 否 | Long | 音頻采樣率 默認值：無，由speaker指定默認值 可選值：8000/16000/24000 |
| volume | 否 | Float | 合成音量 默認值：1.0 可選值：0.1-1.0 |
| pitch | 否 | Float | 語調(diào)參數(shù)，參數(shù)小于0則語調(diào)變低，反之則高 默認值：0 可選值：-10<pitch<10 (streaming接口不支持) |
| symbol_sil | 否 | String | 符號停頓時長映射方法（逗號分割)見下方停頓符號映射表 充值后自動開通權(quán)限 (streaming接口不支持) 如：symbol_sil=semi_200,exclamation_200,question_200,comma_200,stop_200 |
| ignore_limit | 否 | Boolean | 默認值：false 可選值：false/true 是否限制字符數(shù)，如果設(shè)置true，傳輸?shù)奈谋究梢猿^1000字符限制，最大字符數(shù)3000 充值后自動開通權(quán)限 |
| gen_srt | 否 | Boolean | 可以控制是否生成對應(yīng)的srt字幕文件。當(dāng)ignore_limit為true時，audio_type為wav可以返回字幕，其他類型不行。默認不生成字幕文件。生成字幕文件需要額外付費，價格詳情參考報價頁。srt文件地址通過response header返回，參考下面response header樣例。 默認值：false 可選值：false/true |
| merge_symbol | 否 | Boolean | 粗粒度合成參數(shù)，默認為false。可以指定為true，打開后語氣停頓會更加接近真人效果，merge_symbol開啟會導(dǎo)致symbol_sil參數(shù)無效。 默認值：false 可選值：false/true |
| srt_len | 否 | Long | 生成字幕的最大長度，如若為中文字幕遇到，,。!！？?;；等符號會自動分句拆分字幕 |
| streaming | 否 | Boolean | 是否流式輸出，默認為false。可以指定為true，打開后ignore_limit 為true且audio_type 不為wav時，接口流式輸出 |
Request Header設(shè)置
{
"Content-Type": "application/json"
}Request Body格式
body采用json格式傳輸
{
"signature": "appkey+secret+timestamp的MD5值",
"timestamp": "1665717322",
"appkey": "開發(fā)者應(yīng)用appkey",
"speaker": "cissy_meet",
"ignore_limit": true,
"gen_srt": true,
"audio_type": "mp3",
"text": "海南長臂猿的叫聲，高亢洪亮，響徹山谷。海南熱帶雨林國家公園是這種瀕危靈長類動物的全球唯一棲息地。經(jīng)過近年來的科學(xué)保護和生態(tài)恢復(fù)，海南長臂猿已由最少時的寥寥幾只，恢復(fù)到5群35只，創(chuàng)造了世界珍稀動物保護的奇跡。國家公>園堪稱最美國土，具有典型獨特的自然生態(tài)系統(tǒng)、世界矚目的野生動植物種。在海南熱帶雨林國家公園，這里生長著846種特有植物、145種國家重點保護野生動物，生物多樣性指數(shù)與巴西亞馬孫雨林相當(dāng)。2018年4月，習(xí)近平總書記在慶祝海>南建省辦經(jīng)濟特區(qū)30周年大會上強調(diào)，要積極開展國家公園體制試點，建設(shè)熱帶雨林等國家公園。2019年1月，總書記又主持召開中央全面深化改革委員會第六次會議，審議通過《海南熱帶雨林國家公園體制試點方案》。被稱為海南“生態(tài)綠心”的這片最美國土邁出保護和建設(shè)的歷史性一步。我國的國家公園在自然保護地體系中保護等級最高、生態(tài)價值最大、管控措施最嚴。",
"speed": "1.0"
}如果成功合成，則直接返回語音流。
Response Header格式
{
"Content-Type": "audio/mpeg",
"srt_address": "https://mobvoi-speech-public.cn-bj.ufileos.com/mobvoi-tts/openapi/subtitle/d5c27272b28f8596ac0bf6183929d6de.srt?v=1666856127099"
}body中是合成后的音頻數(shù)據(jù)，可以保存成音頻文件，或者交給播放器進行語音播放。
如果合成音頻文件失敗，返回json格式信息，包含具體的錯誤原因。
Error Response Body
{
"status": "error",
"errorMessage": {
"code": 31002,
"desc": "failed to convert text to speech"
}
}Q：如何找到序列猴子 API
A：冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺，專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關(guān)鍵詞搜索API(例如，輸入’序列猴子 API‘這類品類詞，更容易找到結(jié)果)、或者從API hub分類頁進入尋找。
Q：網(wǎng)絡(luò)連接問題？
A：確保網(wǎng)絡(luò)環(huán)境穩(wěn)定，并適當(dāng)配置網(wǎng)絡(luò)設(shè)置。
Q：防火墻和代理配置？
A：某些網(wǎng)絡(luò)環(huán)境要求通過代理服務(wù)器或防火墻才能訪問Internet，若配置不當(dāng)，API請求可能會被阻止。正確配置代理和網(wǎng)絡(luò)規(guī)則，確保API請求能夠順利發(fā)出。
Q：權(quán)限和認證問題？
A：確保API密鑰或訪問令牌正確且有效，并檢查接口文檔，確保請求中包含所有必需的參數(shù)和頭信息。
Q：參數(shù)缺失或類型錯誤？
A：仔細閱讀API文檔，了解參數(shù)的具體要求，并確保提交的參數(shù)符合規(guī)定。
Q：API網(wǎng)關(guān)可以綁定內(nèi)網(wǎng)域名嗎？
A：
對于共享版，域名必須完成備案，并將其CNAME解析到API分組對應(yīng)的子域名。不能將無法在公網(wǎng)訪問的域名，或者將他人所有的域名綁定給API分組。
對于專享版，可以配置內(nèi)網(wǎng)域名，域名不需要備案，并將A記錄解析到實例的入口地址。
提供AI大模型API的服務(wù)商除了序列猴子 API，還有其他替代服務(wù)商也提供類似api服務(wù)，例如：
CARV API開放平臺、Censorfy API開放平臺、新壹科技 API開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q：序列猴子 API這個密鑰還適用于哪些api？
語音合成（TTS）、語音合成標記語言（SSML）、一句話識別
本文全面且細致地介紹了如何獲取序列猴子API開放平臺密鑰的分步指南，為開發(fā)者們提供了一份條理清晰、操作簡便的實用手冊。從序列猴子API平臺的賬號注冊，到完成開發(fā)者身份的認證，再到最終成功獲取API密鑰，每一步操作都配以詳盡的說明與指導(dǎo)，確保開發(fā)者能夠輕松、準確地完成整個流程。獲取密鑰只是利用序列猴子API的第一步，如何高效、穩(wěn)定地集成并應(yīng)用這些強大的序列數(shù)據(jù)處理功能才是關(guān)鍵。因此，在本文中，我們不僅指導(dǎo)了如何獲取密鑰，還特別強調(diào)了獲取后進行初步測試與驗證的重要性。通過測試，開發(fā)者可以確保序列猴子API能夠順利集成到應(yīng)用中，并發(fā)揮出最佳效果，從而提升應(yīng)用的性能和數(shù)據(jù)處理能力。本文為開發(fā)者們提供了一個全面、詳盡且極具實用性的操作指南，幫助他們順利獲取序列猴子API開放平臺的密鑰，并將這一強大的序列數(shù)據(jù)處理能力高效地集成到應(yīng)用中。我們相信，隨著開發(fā)者們對這一指南的深入理解和實踐，將能夠在序列數(shù)據(jù)處理和分析領(lǐng)域取得更加顯著的成果，為科研探索和數(shù)字媒體發(fā)展貢獻更多力量。
