创建喊话器音频资源 - 司空 2 OpenAPI V0.9

创建新的音频资源，支持voice和TTS类型

请求参数

Path 参数

proj_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

content

string

TTS文本内容

必需

当 FileType=tts 时 required: true
example: "请注意安全距离"

create_scene

enum<string>

必需

创建场景(import:导入 record:录制)
enum: import,record
example: "import"

枚举值:

importrecord

duration

integer

音频时长(秒)

必需

当 FileType=audio 且 CreateScene=record 时 required: true
example: 30

file_type

enum<string>

必需

文件类型(audio:音频文件 tts:文字转语音)
enum: audio,tts
example: "audio"

枚举值:

audiotts

name

string

必需

资源名称
example: "警告音频"

need_opus

boolean

是否需要转换为opus格式

可选

example: false

object_key

string

对象存储键值

可选

当 FileType=audio 时 required: true
example: "speaker/123/warning.mp3"

project_id

string

必需

项目ID
example: "ws-123456"

size

integer

文件大小(字节)

可选

当FileType=audio 时 required: true
example: 1024

visible

boolean

是否可见

可选

当 FileType=tts 或者 CreateScene=import 时 required: true
example: true

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "id": 31,
        "name": "测试",
        "file_type": "tts",
        "state": "",
        "content": "这是一条测试音频",
        "md5_sum": "936b7028f55bc787361ed4d2c5aa5d4c",
        "created_at": 1750819438
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功响应

Body

code

integer

响应码

可选

message

string

响应消息

可选

data

object

可选

content

string

可选

TTS文本内容
example: "请注意安全距离"

created_at

integer

可选

创建时间戳
example: 1609459200

duration

integer

可选

音频时长(秒)
example: 30

file_type

enum<string>

可选

文件类型
enum: audio,tts
example: "audio"

枚举值:

audiotts

format

string

可选

文件格式
example: "mp3"

integer

可选

资源ID
example: 123

md5_sum

string

可选

文件MD5校验值
example: "d41d8cd98f00b204e9800998ecf8427e"

name

string

可选

资源名称
example: "警告音频"

object_key

string

可选

对象存储键值
example: "speaker/123/warning.mp3"

object_url

string

可选

对象访问URL
example: "https://example.com/speaker/123/warning.mp3"

pcm_md5_sum

string

可选

PCM格式文件MD5校验值
example: "d41d8cd98f00b204e9800998ecf8427e"

pcm_object_key

string

可选

PCM格式文件存储键值
example: "speaker/123/warning.pcm"

pcm_object_url

string

可选

PCM格式文件访问URL
example: "https://example.com/speaker/123/warning.pcm"

pcm_size

integer

可选

PCM格式文件大小(字节)
example: 2048

size

integer

可选

文件大小(字节)
example: 1024

state

string

可选

资源状态
example: "ready"

state_message

string

可选

状态信息
example: "转换完成"

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "id": 32,
        "name": "测试2",
        "file_type": "tts",
        "state": "",
        "content": "这是第二条测试",
        "md5_sum": "45486fd3c3c918dedc9a3b3232945067",
        "created_at": 1750819956
    }
}