创建异步转录任务

POST

https://router.shengsuanyun.com/api/tasks/generations

创建一个异步转录任务。接口会返回任务 ID，转录完成后可通过任务查询接口或回调获得结果（通常是结果文件的外部 URL）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "file": "https://example-bucket.oss-cn-beijing.aliyuncs.com/audio/input-01.mp3",
    "model": "whisper-1",
    "response_format": "json",
    "language": "en"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://router.shengsuanyun.com/api/tasks/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "file": "https://example-bucket.oss-cn-beijing.aliyuncs.com/audio/input-01.mp3",
    "model": "whisper-1",
    "response_format": "json",
    "language": "en"
}'

返回响应

🟢200成功

application/json

任务创建成功

Body

示例

{
    "code": "success",
    "message": "",
    "data": {
        "request_id": "20250925172708855186000X7N0JqUG",
        "task_id": "f200345e-5dc0-45ef-aa1a-40ed2bf70d3f",
        "action": "AUDIO_TRANSCRIPTION",
        "status": "PENDING",
        "fail_reason": "",
        "submit_time": 1758792429,
        "start_time": 0,
        "finish_time": 0,
        "progress": "0%",
        "data": {
            "text_urls": [],
            "progress": 0
        }
    }
}

🟠400请求有误

🟠401未认证

修改于 2025-09-25 10:01:30

同步音频转录

火山引擎图片处理