加载中...

基础信息

查看接口基本信息和返回格式

免责声明

本平台提供的API服务均来自互联网,可能包含生成式AI内容。所有返回内容仅供参考,平台不对内容的准确性、完整性、时效性或适用性做任何保证。使用者应自行判断并承担使用风险。

接口描述

多角色语音合成,支持不同语气合成

七日请求统计
本周总请求: - 日均: -
请求方式
GET POST 推荐
请求地址
https://dome.api.yunmge.com/api/voicehc
返回方式
JSON 默认返回格式,包含完整数据结构
AUDIO 音频二进制流,Content-Type: audio/*
返回预览
JSON
AUDIO
JSON
{
  "code": 200,
  "data": {
    "text": "您好,这里是云萌阁API,欢迎您的到来,网站地址:api.yunmge.com",
    "filelink": "http://asr-tmp-resource.oss-cn-shanghai.aliyuncs.com/text-to-voice/74ff3ffdc944419886525c91c7e007e3.mp3?OSSAccessKeyId=LTAItIQd1kGPPB9P&Expires=1752161123&Signature=qZl06FbjOWJHAShVAvSrAfwGI5w%3D",
    "msg": "合成语音将在5分钟后删除,请及时保存!"
  },
  "msg": "请求成功",
  "time": "2025-07-06 23:59:05",
  "ip": "127.0.0.1"
}

计费标准

了解接口的计费方式和价格
免费接口
免费
完全免费
所有用户均可免费调用,无需付费
QPS限制
普通用户
999999
次/分钟
会员用户
999999
次/分钟
每日请求次数
普通用户
999999
次/天
会员用户
999999
次/天

安全认证

了解接口的认证方式和访问凭证管理
Token 认证

登录后可查看您的Token

立即登录
实名认证
无需实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
推荐 Header 认证

通过 HTTP Header 传递认证信息

Authorization
Bearer {access_token}

或通过curl请求参数传递:

curl
curl "https://dome.api.yunmge.com/api/voicehc?token=YOUR_TOKEN"

参数文档

查看接口请求参数和返回字段说明
请求参数
参数名 类型 必填 默认值 可选值 说明
token string 必填 登录后显示你的请求token 接口请求唯一认证标识!
mode string 可选 json json、video 返回类型
voice string 可选 maoxiaomei maoxiaomei(猫小美)、xiaoxian(小仙)、maoxiaomei(猫小美)、zhixiaobai(知小白)、ruoxi(若兮)、siqi(思琪)、laomei(老妹)、aida(艾达)、zhifeng_emo(知峰)、laotie(老铁)、zhiwei(知薇-萝莉女声)、zhiru(知茹-新闻女声)、zhiqian(知倩-资讯女声)、zhijia(知佳-标准女声)、zhiqi(知琪-温柔女声)、zhilun(知伦-悬疑解说)、zhifei(知飞-激昂解说)、zhide(知德-新闻男声)、zhinan(知楠-广告男声)、zhixiang(知祥-磁性男声) 人物语音角色
rate string 可选 5 1-9 说话语速
text string 必填 合成内容
返回参数
字段名 类型 说明
code
int 返回状态码
text
string 合成内容
filelink
string 合成语音链接

状态码

了解接口返回的状态码含义及处理方式
接口状态码
状态码 说明
200 请求成功
351 语音合成失败
服务器状态码

在线测试

在线调试接口,实时查看响应结果
发起请求
GET/POST

示例代码

多种语言的接口调用示例
PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言
PHP
<?php
$API_TOKEN = 'YOUR_TOKEN';
$API_URL = 'https://dome.api.yunmge.com/api/voicehc';

$params = array(
    'token' => 'YOUR_TOKEN',
    'mode' => 'json',
    'voice' => 'maoxiaomei',
    'rate' => '5',
    'text' => '无',
);

$res = api::send($API_URL, $params, 'GET/POST');
print($res);

class api {
    public static function send($url, $data, $type) {
        $data = http_build_query($data);
        $ch = curl_init();
        if ($type == 'POST') {
            curl_setopt($ch, CURLOPT_URL, $url);
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        } else {
            curl_setopt($ch, CURLOPT_URL, $url . '?' . $data);
        }
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        $res = curl_exec($ch);
        curl_close($ch);
        return $res;
    }
}
JavaScript
$.ajax({
    url: 'https://dome.api.yunmge.com/api/voicehc',
    data: {
        token: 'YOUR_TOKEN',
        mode: 'json',
        voice: 'maoxiaomei',
        rate: '5',
        text: '无',
    },
    type: 'GET/POST',
    dataType: 'json',
    success: function(data) {
        console.log(data);
    },
    error: function(err) {
        console.log('请求失败', err);
    }
});
Python
import requests

url = "https://dome.api.yunmge.com/api/voicehc"
data = {
    "token": "YOUR_TOKEN",
    "mode": "json",
    "voice": "maoxiaomei",
    "rate": "5",
    "text": "无",
}

response = requests.post(url, data=data)
print(response.json())
Java
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;

public class ApiRequest {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://dome.api.yunmge.com/api/voicehc");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET/POST");
        conn.setConnectTimeout(10000);

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream()));
        String line;
        StringBuilder result = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            result.append(line);
        }
        reader.close();
        System.out.println(result.toString());
    }
}
Go
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
"strings"
)

func main() {
    data := "token=YOUR_TOKEN&mode=json&voice=maoxiaomei&rate=5&text=%E6%97%A0"
    resp, _ := http.Post("https://dome.api.yunmge.com/api/voicehc",
        "application/x-www-form-urlencoded", strings.NewReader(data))
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        var data = new FormUrlEncodedContent(new Dictionary<string, string> {
            {"token", "YOUR_TOKEN"},
            {"mode", "json"},
            {"voice", "maoxiaomei"},
            {"rate", "5"},
            {"text", "无"},
        });
        var response = await client.PostAsync("https://dome.api.yunmge.com/api/voicehc", data);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(response);
    }
}
NodeJs
const https = require('https');
const querystring = require('querystring');

const postData = querystring.stringify({
    'token': 'YOUR_TOKEN',
    'mode': 'json',
    'voice': 'maoxiaomei',
    'rate': '5',
    'text': '无',
});
const options = {
    hostname: 'dome.api.yunmge.com',
    path: '/api/voicehc',
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
};
const req = https.request(options, res => {
    let data = '';
    res.on('data', d => data += d);
    res.on('end', () => console.log(data));
});
req.write(postData);
req.end();
C
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>

static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
    ((char*)userp)[0] = '\0';
    strcat(userp, contents);
    return size * nmemb;
}

int main() {
    CURL *curl;
    CURLcode res;
    char response[4096] = {0};

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://dome.api.yunmge.com/api/voicehc");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&voice=maoxiaomei&rate=5&text=%E6%97%A0");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        res = curl_easy_perform(curl);
        if(res == CURLE_OK) printf("%s\n", response);
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
C++
#include <iostream>
#include <string>
#include <curl/curl.h>

size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
    userp->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    std::string response;

    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://dome.api.yunmge.com/api/voicehc");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&voice=maoxiaomei&rate=5&text=%E6%97%A0");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK) std::cout << response << std::endl;
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
易语言
.版本 2
.支持库 spec

.局部变量 url, 文本型
.局部变量 params, 文本型
.局部变量 result, 文本型

url = "https://dome.api.yunmge.com/api/voicehc"
params = "token=YOUR_TOKEN&mode=json&voice=maoxiaomei&rate=5&text=%E6%97%A0"

result = 编码_URL解码 (网页_访问 (url, , params))
调试输出 (result)

AI开发文档

导出接口文档供AI助手快速理解接口结构
复制下方内容粘贴给AI助手,即可快速生成对接代码。
JSON 格式 0 KB