Create Speaker Resource

POST

/openapi/v2.0/speaker/api/v1/workspaces/{workspace_id}/resources

Create a speaker voice resource under current project. Supports two types: Audio File (file_type=audio, first call STS API to obtain upload credentials, upload audio to object storage, then call this API to submit object_key); TTS Text (file_type=tts, directly submit text; server asynchronously synthesizes audio and transcodes). Two-Phase Recording Scenario (create_scene=record): frontend records → first call this API with visible=false to create placeholder index → user confirms save, then call edit API to set visible=true; resource only appears in list. Import Scenario (create_scene=import): directly create with visible=true.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "name": "Do Not Approach",
    "file_type": "audio",
    "create_scene": "import",
    "object_key": "speaker/{org}/{prj}/abc.mp3",
    "size": 524288,
    "visible": true,
    "need_opus": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/speaker/api/v1/workspaces//resources' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Do Not Approach",
    "file_type": "audio",
    "create_scene": "import",
    "object_key": "speaker/{org}/{prj}/abc.mp3",
    "size": 524288,
    "visible": true,
    "need_opus": true
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "id": 103,
        "name": "Do Not Approach",
        "file_type": "audio",
        "object_key": "speaker/{org}/{prj}/abc.mp3",
        "object_url": "https://oss.example.com/speaker/.../abc.mp3?signed=...",
        "size": 524288,
        "state": "transcoding",
        "md5_sum": "",
        "created_at": 1717890200
    }
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Query Speaker Resource List

Delete Speaker Resource