从文本生成音频

创建一个新的文本转语音 (TTS) 作业，将输入文本异步转换为音频。

API 响应因接受标头而异，提供作业数据或服务器发送事件 (SSE) 文本事件流来跟踪作业进度。

如果标头包含，API 将返回有关新创建的 TTS 作业的信息：accept: application/json

地位：201 - Created

标题：- 最近创建的作业的 URLLocation: /api/v2/tts/{id}

正文：作业数据（与的响应相同）GET /api/v2/tts/{id}

如果标头包含或，或者存在查询参数，端点将使用作业创建进度 SSE 文本事件流进行响应：accept: text/event-stream``accept: */*``?format=event-stream

地位：201 - Created

标题：

Location: /api/v2/tts/{id}- 最近创建的作业的 URL

Content-Location: /api/v2/tts/{id}?format=event-stream- SSE 流的 URL

Body：事件流（与相同）/api/v2/tts/{id}?format=event-stream

注意：创建的作业是短暂的，将在 48 小时后删除。另一方面，生成的文件是永久性的，并且可供下载至少 30 天。

curl --location --request POST 'http://dev-cn.your-api-server.com/api/v2/tts' \ --header 'AUTHORIZATION: YOUR_SECRET_KEY_HERE' \ --header 'X-USER-ID: YOUR_USER_ID_HERE' \ --header 'content-type: application/json' \ --data-raw '{ "text": "Hello from a realistic voice.", "voice": "s3://voice-cloning-zero-shot/d9ff78ba-d016-47f6-b0ef-dd630f59414e/female-cs/manifest.json", "output_format": "mp3", "voice_engine": "PlayHT2.0" }'

{ "id": "f0gZrOKBKL7veJ6o1M", "created": "2023-03-04T01:12:03.981Z", "input": { "text": "Hello! Said the realistic voice.", "voice": "s3://voice-cloning-zero-shot/d9ff78ba-d016-47f6-b0ef-dd630f59414e/female-cs/manifest.json", "quality": "draft", "output_format": "mp3", "speed": 1, "sample_rate": 24000, "seed": null, "temperature": null, "voice_engine": "PlayHT2.0", "emotion": "female_happy", "voice_guidance": 3, "style_guidance": 20 }, "output": { "duration": 1.664, "size": 35085, "url": "https://peregrine-results.s3.amazonaws.com/pigeon/f0gZrOKBKL7veJ6o1M_0.mp3" }, "_links": [ "{\n href: 'https://play.ht/api/v2/tts/f0gZrOKBKL7veJ6o1M',\n method: 'GET',\n contentType: 'application/json',\n rel: 'self',\n description: \"Fetches this job's data. Poll it for the latest status.\",\n}\n" ] }

从文本生成音频

请求参数

返回响应