在线调试
填写业务相关参数免费在线调试
该分类下无相关接口
语音合成PRO任务:实时输出b64编码音频api,文字转语音实时音频接口,音频流base64编码语音合成api接口,实时音频转换接口,实时音频流输出api。
接口地址:https://api.kuhuyun.com/api/ai/audiotaskpro
返回格式:application/json
请求方式:HTTPGET/POST
请求示例:https://接口地址?key=你的key
声音复刻PRO:https://www.kuhuyun.com/doc/52
语音合成PRO:https://www.kuhuyun.com/doc/53
1个中文2字符,1个英文字母、1个标点或1个句子中间的空格均算作1个字符
| 名称 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded;charset:utf-8; |
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| text | 是 | string | 我像小草一样在发芽。 | 文本内容,单次请求文本内容不超过2000字符,使用中文符号,支持识别中小学常见的数学表达式,包括但不限于基础运算、代数、几何等内容 |
| voice | 是 | string | voice-c0c835a0b2714d1b9c4a10203edf857e | 音色ID,通过声音复刻PRO返回的 |
| format | 否 | string | mp3 | 流式输出音频格式,默认mp3,支持mp3、wav、pcm音频格式 |
| sample_rate | 否 | string | 22050 | 输出音频采样率,支持下述采样率:8000=8kHz, 16000=16kHz, 22050=22.05kHz, 24000=24kHz, 44100=44.1kHz, 48000=48kHz |
| volume | 否 | string | 50 | 音量调整(0~100),默认50 |
| rate | 否 | string | 1.0 | 语速调整(0.5~2),默认1.0 |
| pitch | 否 | string | 1.0 | 音调调整(0.5~2),默认1.0 |
| 音色ID | 名称 | 场景 | 语言 | 性别 | 音频试听 |
|---|---|---|---|---|---|
| voice-9cd3f01a272e4bbc901952f54bf37c1e | 猴哥 | 网络男声 | 中文 | 男 | |
| voice-33ae1762aec2414294ae3d8a8c4be7e1 | 熊大 | 网络男声 | 中文 | 男 | |
| voice-17d45a81c259448887dc8ba8bf38399f | 四郎 | 网络男声 | 中文 | 男 | |
| voice-199bab3896604a86ba428692398f60c5 | TVB女声 | 网络女声 | 中文 | 女 | |
| voice-88f44ca999f84a88858235f3a2c70532 | 海绵宝宝 | 网络男声 | 中文 | 男 | |
| voice-68beebe041664a99ba6f3dd47a68a1a9 | 艾伦 | 网络男声 | 中文 | 男 | |
| voice-a8e37b4a00664b44afbe7c2e98d4b89d | 志玲 | 网络女声 | 中文 | 女 | |
| voice-4cf8f0632dfa4c808e5c3156fa30fd62 | 妲己 | 网络女声 | 中文 | 女 | |
| voice-69d7d91e0fd4493685fc174e947b6a67 | 东北老铁 | 网络男声 | 中文 | 男 | |
| voice-dd06c69aa67f4f04b712f7b7c2b48d6f | 小婉 | 口播、数字人 | 中文 | 女 | |
| voice-32dada61ffad4042a5a669ae91b7f2b6 | 小橙 | 口播、数字人 | 中文 | 男 | |
| voice-4713c85e046f443187ccf143c28bad95 | 小华 | 口播、数字人 | 中文 | 女 | |
| voice-ad58ee4083df4eb69c1f561f4a1cdb9e | 小淳 | 口播、数字人 | 中文+英文 | 女 | |
| voice-775cafcb8d6e49e98eb893482294c8f6 | 小夏 | 口播、数字人 | 中文 | 女 | |
| voice-a12bd492506c4fb0b09532cd7559cbdb | 小诚 | 口播、数字人 | 中文+英文 | 男 | |
| voice-e456ffa8fc0f46e3b2bbba22f23b5783 | 小白 | 口播、数字人、有声书 | 中文 | 女 | |
| voice-d03433918bb94e6798d598524d4e2a07 | 老铁 | 口播、数字人、有声书、新闻播报、直播带货 | 中文东北口音 | 男 | |
| voice-f4b07da64d6f490babf4b499dbeb56d1 | 小书 | 口播、数字人、有声书、新闻播报、客服 | 中文 | 男 | |
| voice-a1d77811e28248fa88370727fe3431a1 | 小硕 | 口播、数字人、新闻播报、客服 | 中文 | 男 | |
| voice-449fd8440b29467d89f0b22c7652218b | 小婧 | 口播、数字人、新闻播报、客服 | 中文 | 女 | |
| voice-ae52668e51304012a6a2227b88208a9d | 妙妙 | 口播、数字人、有声、客服 | 中文 | 女 | |
| voice-1a035370fd6a4eac85693dfbc3c469b7 | 悦悦 | 口播、数字人、有声、客服、诗词、新闻 | 中文 | 女 | |
| voice-a338045e378144e58095410a2427f098 | 小媛 | 口播、数字人、有声 | 中文 | 女 | |
| voice-d416034b0f2a4c27972e4e064c5bada0 | 小飞 | 会议、新闻、有声 | 中文 | 男 | |
| voice-f717b61b61344e488a5af5f02a312ad5 | 小杰力豆 | 聊天助手、新闻、有声 | 中文+英文 | 男童 | |
| voice-fb997ff38d08477cbe2ec3c157b75d27 | 小彤 | 口播、数字人、有声 | 中文 | 女童 | |
| voice-54c1ce30679d4d6d96d167ccfa575753 | 小祥 | 口播、新闻、有声 | 中文 | 男 | |
| voice-822c3e360e094914810636571a0f7f9f | collins | 口播、数字人、有声、带货、客服 | 中文+英文 | 女 | |
| voice-8fde33b927ac4bd592ab86e8c5319b23 | Belala | 口播、数字人、新闻、客服 | 中文 | 女 | |
| voice-de4525674616477ab1d30a7ab84b2475 | 豆豆 | 阳光顽皮男孩 | 中文+英文 | 男童 | |
| voice-236303ba8da44b09abd02a2ed7d23a95 | 铃铃 | 稚气呆板女孩 | 中文+英文 | 女童 | |
| voice-31ea1e471f704391b73418fb732e5e9b | 可可 | 懵懂乖乖女孩 | 中文+英文 | 女童 | |
| voice-c95585745bb34f3c992bf725f08cfc06 | 燃燃 | 直播、活泼质感女孩 | 中文+英文 | 女 | |
| voice-49e600f876ed412287c2423c1d5f3b15 | 宣宣 | 直播、经典直播女孩 | 中文+英文 | 女 |
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | string | 请求结果数据集 |
| request_params | string | 请求信息 |
| task_id | string | 返回任务id |
| audio_base64 | string | 返回音频数据,base64编码格式,直接保存为音频文件即可 |
| debug | string/array | 调试数据 |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
| 错误码 | 类型 | 说明 |
|---|---|---|
| 403 | int | 没有权限 |
| 400 | int | 参数传递不正确 |
| 500 | int | 服务器内部错误 |
<?php
/**
* API请求DEMO
* 建议使用豆包AI写DEMO代码【方法:把本API文档发给豆包要求写一份API请求示例即可获得结果】
*
* 本demo支持GET与POST请求,同时支持签名验证与无需签名。
*/
//你申请的key密钥
$API_KEY = '你的接口密钥,登录控制台后在密钥管理页面申请';
//API接口地址
$API_URL = 'https://api.kuhuyun.com/api/ai/audiotaskpro';
$get_post_data = array(
//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
'key' => $API_KEY,
'参数名' => '参数值',
);
//签名校验的 SK:(在用户控制台https://api.kuhuyun.com/user/key的秘钥安全设置->签名校验 开启后才会生效,没开启签名校验留空即可。)
$sk = '56777ab62ff752fbd57ab7228fc2fc43';
/*发起请求API接口:
第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
第4个参数:是否验证签名,true验证签名,否则false不验证签名,根据用户控制台 https://api.kuhuyun.com/user/key 的 秘钥安全设置->签名校验 开启后才会生效,如没开启,填写false即可。
第5个参数:如果第4个参数开启验证签名,此处必须填写 SK ,跟上面的同名变量相对应,无需更改。
*/
$resdata = api::send($API_URL, $get_post_data, 'GET', true, $sk); //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据
/**
* API请求类
*/
class api
{
public static function send($API_URL, $get_post_data, $type, $ifsign, $sk)
{
$get_post_data = http_build_query($get_post_data);
if ($ifsign) {
$sign = md5($get_post_data . $sk);
$res = self::send_curl($API_URL, $type, $get_post_data, $sign);
} else {
$res = self::send_curl($API_URL, $type, $get_post_data, null);
}
return $res;
}
//封装好的CURL请求函数,支持POST|GET
public static function send_curl($API_URL, $type, $get_post_data, $sign)
{
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $API_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
} elseif ($type == 'GET') {
curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
}
if ($sign) {
curl_setopt($ch, CURLOPT_HTTPHEADER, ['sign:' . $sign]);
}
curl_setopt($ch, CURLOPT_REFERER, $API_URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$resdata = curl_exec($ch);
curl_close($ch);
return $resdata;
}
}
//jQuery-Ajax
$.ajax({
url: 'https://api.kuhuyun.com/api/ai/audiotaskpro',
data: {
//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
key: '你的接口密钥,登录控制台后在密钥管理页面申请',
参数名: '参数值',
},
type: 'GET', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
| 子程序名 | 返回值类型 | 公开 | 备 注 | ||
| __启动窗口_创建完毕 | |||||
| 子程序名 | 返回值类型 | 公开 | 备 注 | ||
| Send_API | |||||
| 变量名 | 类 型 | 静态 | 数组 | 备 注 | ||
| REQU_Data | 文本型 | 提交字符串 | ||||
| return | 文本型 | 返回字符串 | ||||
| API_URL | 文本型 | 接口地址 | ||||
| API_KEY | 文本型 | 接口密钥 | ||||
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Test {
public static void main(String[] args) {
try {
URL url = new URL("https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请");
HttpURLConnection connection = (HttpURLConnection)url.openConnection();
// 设置请求方式
connection.setRequestMethod("GET");
connection.connect();
// 获取响应码
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
while ((line = reader.readLine()) != null) {
// 读取到的内容给line变量
System.out.println(line);
}
reader.close();
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 发起一个GET请求
resp, err := http.Get("https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请")
if err != nil {
fmt.Println("http get error", err)
return
}
// 读取响应结果
result, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("http read error", err)
return
}
// 关闭响应结果
defer resp.Body.Close()
fmt.Println(string(result))
}
```
# 导入requests库
import requests
# 设置url
url = 'https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请'
# 发送post请求
response = requests.post(url, data={'key1': 'value1', 'key2': 'value2'})
# 获取响应内容
result = response.json()
# 打印结果
print(result)
```
// 以下是使用Node.js进行GET和POST请求API接口的示例代码:
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'api.kuhuyun.com',
path: '/api/ai/audiotaskpro',
method: 'GET'
};
// 发送GET请求
https.get(options, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
}).on('error', error => {
console.error(error);
});
// 发送POST请求
const postData = querystring.stringify({
'key1': 'value1',
'key2': 'value2'
});
const postOptions = {
hostname: 'api.kuhuyun.com',
path: '/api/ai/audiotaskpro',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
/*
这个示例代码使用Node.js内置的`https`模块进行HTTP请求。
首先定义了一个GET请求的选项,然后使用`https.get()`方法发送了GET请求。在响应流上注册回调函数,以便在收到响应数据时将其输出到控制台。在出现错误时,也注册了错误处理程序。
类似地,我们也定义了一个POST请求选项,并使用`https.request()`方法发送它。需要在请求头中包含适当的`Content-Type`和`Content-Length`以确保服务器可以正确解析请求体。请求体由`write()`方法写入,并在请求结束时通过调用`end()`方法通知请求对象已经完成。
注意,此示例默认使用`querystring`模块将数据作为x-www-form-urlencoded格式进行编码。如果需要使用其他格式(如JSON),则需要相应地更改请求头和请求体的编码方式。
另外,为了确保HTTPS请求的安全性,您也可以添加其他选项,例如验证服务器证书、设置代理等。
*/
以下是使用C语言进行GET和POST请求API接口的示例代码:
``` c
#include
#include
#include
#include // 需要安装curl库
// API地址
const char* url = "https://api.kuhuyun.com/api/ai/audiotaskpro";
// GET请求
void getRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 设置POST数据
const char* postData = "key=你的接口密钥,登录控制台后在密钥管理页面申请&key1=value1";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl;
CURLcode res;
// 初始化curl
curl = curl_easy_init();
if(curl) {
// 设置SSL验证
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
// GET请求
getRequest(curl);
// POST请求
postRequest(curl);
// 清理curl资源
curl_easy_cleanup(curl);
}
return 0;
}
```
这个示例代码使用了libcurl库进行HTTP请求。
首先,需要设置API地址。然后,基于`CURL`结构体创建curl句柄,并使用`curl_easy_setopt()`函数设置选项。这里设置了SSL验证,以确保请求的安全性。
在GET请求中,只需将URL设置为选项,然后调用`curl_easy_perform()`函数执行请求即可。
在POST请求中,还需要将POST数据作为字符串传递给`CURLOPT_POSTFIELDS`选项。
需要注意的是,为了避免内存泄漏,应该在使用完curl句柄之后调用`curl_easy_cleanup()`函数进行清理。
除了上述示例代码外,libcurl库还提供了更多高级选项,例如处理HTTP头、上传文件等。可以参考文档进行更详细的了解。
以下是一个使用C++请求API接口的示例代码:
```cpp
#include
#include
int main() {
CURL *curl;
CURLcode res;
std::string url = "https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请";
std::string response;
curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](char *ptr, size_t size, size_t nmemb, void *userdata) -> size_t {
std::string *response = reinterpret_cast(userdata);
response->append(ptr, size * nmemb);
return size * nmemb;
});
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
res = curl_easy_perform(curl);
if (res == CURLE_OK) {
std::cout << "Response: " << response << std::endl;
} else {
std::cerr << "Error: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
```
解释:
1. 引入需要的头文件:``用于输出结果,``用于使用libcurl库。
2. 定义需要请求的API接口的URL和存储响应数据的字符串变量。
3. 初始化一个CURL对象。
4. 设置CURL对象的参数:请求的URL(`CURLOPT_URL`)、是否跟随重定向(`CURLOPT_FOLLOWLOCATION`)、响应数据的写入函数(`CURLOPT_WRITEFUNCTION`)和响应数据的写入位置(`CURLOPT_WRITEDATA`)。
5. 发送HTTP请求并获取响应数据,判断返回状态码是否OK。
6. 清理CURL对象。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装libcurl库。
以下是一个使用C#请求API接口的示例代码:
```csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main(string[] args) {
HttpClient client = new HttpClient();
string url = "https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请";
HttpResponseMessage response = await client.GetAsync(url);
if (response.IsSuccessStatusCode) {
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine("Response: " + responseBody);
} else {
Console.WriteLine("Error: " + response.StatusCode);
}
}
}
```
解释:
1. 引用需要的命名空间:`System.Net.Http`用于使用HttpClient类,`System.Threading.Tasks`用于异步执行请求操作。
2. 创建一个HttpClient对象。
3. 定义需要请求的API接口的URL。
4. 发送GET请求到指定的API接口URL,并获取响应结果。
5. 判断响应状态是否成功,如果成功则读取响应数据(使用ReadAsStringAsync方法),否则输出错误信息(使用StatusCode属性)。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装.NET Framework或.NET Core SDK。
以下是VB请求API接口的示例代码:
```
' 1. 引入Microsoft XML v6.0库
' 2. 创建一个XMLHTTP对象
Dim xhr As XMLHTTP
Set xhr = New XMLHTTP
' 3. 设置请求的URL、方法,以及是否异步等
xhr.Open "GET", "https://api.kuhuyun.com/api/ai/audiotaskpro?key=你的接口密钥,登录控制台后在密钥管理页面申请", False
' 4. 发送请求
xhr.send
' 5. 获取响应结果
Dim responseText As String
responseText = xhr.responseText
' 6. 输出响应结果
Debug.Print responseText
' 7. 释放资源
Set xhr = Nothing
```
在这个示例中,我们创建了一个XMLHTTP对象,用于请求API接口。我们先调用`open`方法来设置请求的URL、方法,以及是否异步。然后,我们发送请求,并使用`responseText`属性来获取响应结果。最后,我们将响应结果打印到控制台,完成操作后释放资源,以防止内存泄漏。请注意,以上示例代码为同步请求,如果想使用异步请求,需要设置第三个参数为`True`,并在请求结束时处理`OnReadyStateChange`事件。
| 参数名 | 填写参数值 |
|---|---|
填写业务相关参数免费在线调试
生成符合你的开发语言代码,复制即可
调整你后端部分逻辑代码即可上线使用