生成语音
成功的响应是二进制音频,而不是JSON。.
本页面内容
https://api.shareai.now/api/v1/audio/speech生成语音
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
- 必需范围
inferenceormonetization_gateway
成功的响应是二进制音频,而不是JSON。使用以下方式保存 curl --output speech.mp3 或在您的SDK中读取响应字节。选择支持的模型语音和输出格式;速度范围为0.25到4。输入限制为256 KiB,同步响应限制为2 MiB。.
开始之前#
在您的服务器上设置 SHAREAI_API_KEY,并将模型占位符替换为当前启用的模型。切勿在浏览器代码中暴露 API 密钥。模型、账户、凭证和提供者必须全部允许此操作。以下可选设置需要模型支持;API 安全范围并不保证每个模型支持所有值。.
发送请求#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));请求字段#
| 字段 | 类型 | 含义与限制 |
|---|---|---|
model 必需 | 字符串 | 精确启用的公共模型标识符。必须声明此操作并由您的凭证允许。. |
input 必需 | 字符串 | 必需的非空语音文本,最多256 KiB的UTF-8。字符计费基于Unicode字符,而不是编码字节。. |
voice | 字符串 | 可选的语音由所选语音模型支持,最多100个字符。. |
response_format | 字符串 | 可选的支持音频编码格式,例如mp3。成功的响应是二进制音频,而不是JSON。按时长计费的路由需要自描述的MP3、WAV或FLAC。. |
speed | 数字 | 可选的语音速度范围为0.25到4;模型可能会施加更窄的限制。. |
provider | 对象 | 可选的提供者路由偏好。使用 provider.only 接受的提供者标签,而不是模型 ID 的前缀。账户和凭证限制仍然适用。. |
阅读结果#
成功返回HTTP 200并附带二进制音频。成功的响应是二进制音频,而不是JSON。使用以下方式保存 curl --output speech.mp3 或在您的SDK中读取响应字节。选择支持的模型语音和输出格式;速度范围为0.25到4。输入限制为256 KiB,同步响应限制为2 MiB。.
计费单位#
语音可以根据输入字符、提供者报告的令牌或生成的秒数计费,具体取决于模型。字符计数使用Unicode字符。按时长计费需要支持的自描述MP3、WAV或FLAC结果。原始PCM结果没有猜测的采样率。按令牌计费的路由需要可信的使用收据。.
从控制台选择精确启用的模型标识符。其声明的操作和输入/输出能力必须与此端点匹配;文本聊天模型不能替代其他操作。您的凭证、提供者和账户限制仍然适用。.
定价与使用#
费率以选定模型、提供者、单位和变体的 EUR AI 积分发布。仅收费于其活动费率中的维度。估算会在执行前保留积分;最终费用使用测量的使用量。价格可能取决于分辨率、输出格式或使用范围。请检查控制台使用情况以获取最终的 ShareAI 扣款。上游成本字段和媒体字节不会转换为虚构的令牌计数。.
访问与错误#
使用 inference 用于批准的网络成本推理或 monetization_gateway 用于批准的 Builder 加价和接受的计费条款。仅身份访问不授权支出。验证、模型授权、积分不足、费率限制和执行失败会返回结构化 error. 在超时或提交不确定后,请检查使用情况或视频任务,然后再创建另一个可能付费的请求。.
最近更新日期:2026年11月3日