2025年swagger 返回map(swagger 返回多个响应类型)

swagger 返回map(swagger 返回多个响应类型)客户端向服务端发送携带文本内容的 HTTPS nbsp GET 方法或 POST 方法的请求 服务端返回携带合成语音数据的 HTTP 响应 语音合成的请求参数如下表所示 如果使用 HTTPS nbsp GET 方法的请求 需要在 HTTPS 的 URL 请求参数中设置这些参数 如果使用 HTTPS nbsp POST 方法的请求 需要在 HTTPS 的请求体 Body 中设置这些参数

大家好,我是讯享网,很高兴认识大家。



客户端向服务端发送携带文本内容的HTTPS GET方法或POST方法的请求,服务端返回携带合成语音数据的HTTP响应。

image
讯享网

语音合成的请求参数如下表所示。

  • 如果使用HTTPS GET方法的请求,需要在HTTPS的URL请求参数中设置这些参数。
  • 如果使用HTTPS POST方法的请求,需要在HTTPS的请求体(Body)中设置这些参数。

一个完整的语音合成RESTful API GET方法的请求包含以下要素:

  • URL

  • 请求参数

    参见上述。由URL和请求参数组成的完整请求链接如下所示,在浏览器中打开该链接可直接获取语音合成结果:

  • HTTPS GET请求头部

一个完整的语音合成RESTful API POST请求包含以下要素:

  • URL

  • HTTPS POST请求头部

  • HTTPS POST请求体

    HTTPS POST请求体由请求参数组成JSON格式的字符串组成,因此在HTTPS POST请求头部中的Content-Type必须设置为”application/json”。示例如下:

使用HTTPS GET方法和HTTPS POST方法请求的响应是相同的,响应结果都包含在HTTPS的响应体中。响应结果的成功/失败通过HTTPS Headers的字段来区分:

  • 成功响应
    • HTTPS Headers的字段内容为,表示合成成功,合成的语音数据在响应体中。
    • HTTPS Header的字段内容为请求任务的task_id。
    • 响应内容为合成音频的二进制数据。
  • 失败响应
    • HTTPS Headers没有字段,或者字段内容为,表示合成失败,错误信息在响应体中。
    • HTTPS Headers的字段内容为请求任务的task_id。
    • 响应体内容为错误信息,以JSON格式的字符串表示。如下所示:

    • 错误信息字段如下表

依赖文件内容如下:

示例代码如下:

Java(流式合成)示例代码如下:

示例目录说明如下:

  • CMakeLists.txt:示例工程的CMakeList文件。
  • demo:示例文件。
  • include
  • lib:包含curl、jsoncpp动态库。

    根据平台不同,使用如下版本软件加载库文件:

    • linux(Glibc:2.5及以上,Gcc4或Gcc5)
    • windows(VS2013、VS2015)
  • readme.txt:说明文件。
  • release.log:更新记录。
  • version:版本号。
  • build.sh:示例编译脚本。

编译运行操作步骤:

假设示例文件已解压至路径下,在Linux终端依次执行如下命令编译运行程序。

  • 支持Cmake:
    1. 确认本地系统已安装Cmake 2.4及以上版本。
  • 不支持Cmake:

示例代码如下:

小讯
上一篇 2025-06-09 22:07
下一篇 2025-06-13 09:12

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/140497.html