You need to enable JavaScript to run this app.
文档中心
豆包语音

豆包语音

复制全文
下载 pdf
异步长文本语音合成
结果查询
复制全文
下载 pdf
结果查询
用于查询异步长文本语音合成的结果,需传入任务 ID(task_id)获取对应任务的识别状态与结果​
说明​
合成音频在服务端可保存 7 天,过期后将被清理。音频下载链接的有效期为 1 小时,若链接失效,请重新调用接口获取最新下载地址​
POST https://openspeech.bytedance.com/api/v3/tts/query​
请求头​
​
请求体​
​
响应头​
​
响应体​
​
​

输入示例

import time
import uuid
import requests
import json

TASK_ID = "3c23527b-884d-4fec-940c-42086cb3f6fc"
URL = "https://openspeech.bytedance.com/api/v3/tts/query"


def query(url, headers, params):
    session = requests.Session()
    resp = None
    try:
        resp = requests.post(url, json=params, headers=headers)
        logid = resp.headers.get('X-Tt-Logid')
        print(f"X-Tt-Logid: {logid}")

        if resp.status_code != 200:
            print("resp text: ", resp.text)
        else:
            resp_json = resp.json()
            resp_code = resp_json.get("code")
            resp_msg = resp_json.get("message")
            resp_data = resp_json.get("data")
            print(f"响应 code: {resp_code}, message: {resp_msg}")
            print("data: ", resp_data)
    except Exception as e:
        print(f"请求失败: {e}")
    finally:
        if resp is not None:
            resp.close()
        session.close()

if __name__ == "__main__":

    headers = {

        "X-Api-Key": "your_api_key",
        "X-Api-Resource-Id": "seed-tts-2.0",
        "X-Api-Request-Id": str(uuid.uuid1()),
    }

    payload = {
        "task_id": TASK_ID
    }
    print(f"payload: {json.dumps(payload, ensure_ascii=False)}")
    query(url=URL, headers=headers, params=payload)


输出示例

{
    "code": 20000000,
    "message": "ok",
    "data": {
        "task_id": "3c23527b-884d-4fec-940c-42086cb3f6fc",
        "task_status": 2,
        "req_text_length": 9,
        "synthesize_text_length": 9,
        "audio_url": "https://lf26-lab-speech-tt-sign.bytespeech.com/...",
        "url_expire_time": 1788354094,
        "sentences": [
            {
                "startTime": 0.365,
                "endTime": 2.215,
                "text": "提交第一条合成语音。\n",
                "words": [
                    {"word": "提", "startTime": 0.365, "endTime": 0.535, "confidence": 0.886},
                    {"word": "交", "startTime": 0.535, "endTime": 0.805, "confidence": 0.915},
                    {"word": "第", "startTime": 0.805, "endTime": 1.065, "confidence": 0.874},
                    {"word": "一", "startTime": 1.065, "endTime": 1.115, "confidence": 0.637},
                    {"word": "条", "startTime": 1.115, "endTime": 1.405, "confidence": 0.943},
                    {"word": "合", "startTime": 1.405, "endTime": 1.595, "confidence": 0.970},
                    {"word": "成", "startTime": 1.595, "endTime": 1.795, "confidence": 0.944},
                    {"word": "语", "startTime": 1.795, "endTime": 1.945, "confidence": 0.859},
                    {"word": "音。", "startTime": 1.945, "endTime": 2.215, "confidence": 0.851}
                ]
            }
        ]
    }
}
最近更新时间:2026.09.28 19:13:42
这个页面对您有帮助吗?
有用
有用
无用
无用