ShareAI Platform Docs

生成语音

成功的响应是二进制音频,而不是JSON。.

查看为Markdown格式
本页面内容
POST https://api.shareai.now/api/v1/audio/speech

生成语音

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌
必需范围
inference or monetization_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.mp3

请求字段#

字段类型含义与限制
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日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI