ShareAI Platform Docs

生成音频

ShareAI 端点返回一个有限的 JSON 音频结果。.

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

生成音频

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌
必需范围
inference or monetization_gateway

ShareAI 端点返回一个有限的 JSON 音频结果。音频生成请求 modalities:["text","audio"] 也可以使用 /api/v1/chat/completions. 。您的请求将被路由到指定的音频操作。此同步响应在返回前收集;未完成的提供者流不会成为成功计费结果。音频输出格式包括 mp3、wav、flac、pcm16 或 pcm24,具体取决于模型。原始 PCM 不支持时长计费。设置 max_tokens 或 max_completion_tokens 之一以限制生成的令牌;请勿同时提供两者。.

开始之前#

在您的服务器上设置 SHAREAI_API_KEY,并将模型占位符替换为当前启用的模型。切勿在浏览器代码中暴露 API 密钥。模型、账户、凭证和提供者必须全部允许此操作。以下可选设置需要模型支持;API 安全范围并不保证每个模型支持所有值。.

发送请求#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_AUDIO_MODEL",
  "messages": [
    {
      "role": "user",
      "content": "A short instrumental melody."
    }
  ],
  "modalities": [
    "text",
    "audio"
  ],
  "audio": {
    "format": "mp3"
  },
  "max_completion_tokens": 1024
}'

请求字段#

字段类型含义与限制
model 必需字符串精确启用的公共模型标识符。必须声明此操作并由您的凭证允许。.
messages 必需数组1–256 条带有角色/内容的对话消息。仅使用所选音频模型支持的内容模式。.
modalities数组从文本和音频中选择一个或两个唯一值;音频是必需的。默认值为音频。此同步端点不接受流。.
audio对象可选输出选项:仅语音和格式。格式包括 mp3、wav、flac、pcm16 或 pcm24,具体取决于模型支持。原始 PCM 与时长计费不兼容。.
temperature数字可选的模型支持的生成温度。.
top_p数字可选的模型支持的核采样值。.
max_tokens整数可选的输出令牌限制,范围为 1–262144。请勿与 max_completion_tokens 结合使用。.
max_completion_tokens整数可选的输出令牌限制,范围为 1–262144。请勿与 max_tokens 结合使用。.
provider对象可选的提供者路由偏好。使用 provider.only 接受的提供者标签,而不是模型 ID 的前缀。账户和凭证限制仍然适用。.

阅读结果#

成功返回 HTTP 200 和 JSON。ShareAI 端点返回一个有限的 JSON 音频结果。音频生成请求 modalities:["text","audio"] 也可以使用 /api/v1/chat/completions. 。您的请求将被路由到指定的音频操作。此同步响应在返回前收集;未完成的提供者流不会成为成功计费结果。音频输出格式包括 mp3、wav、flac、pcm16 或 pcm24,具体取决于模型。原始 PCM 不支持时长计费。设置 max_tokens 或 max_completion_tokens 之一以限制生成的令牌;请勿同时提供两者。.

计费单位#

音频模型可以发布单独的文本令牌和音频令牌维度、时长、歌曲或请求速率。包含的令牌总数被分割为独立的文本/音频计数器;相同的音频令牌不会再次作为文本计费。不支持或缺失的使用量不会从编码字节中估算。.

从控制台选择精确启用的模型标识符。其声明的操作和输入/输出能力必须与此端点匹配;文本聊天模型不能替代其他操作。您的凭证、提供者和账户限制仍然适用。.

定价与使用#

费率以选定模型、提供者、单位和变体的 EUR AI 积分发布。仅收费于其活动费率中的维度。估算会在执行前保留积分;最终费用使用测量的使用量。价格可能取决于分辨率、输出格式或使用范围。请检查控制台使用情况以获取最终的 ShareAI 扣款。上游成本字段和媒体字节不会转换为虚构的令牌计数。.

访问与错误#

使用 inference 用于批准的网络成本推理或 monetization_gateway 用于批准的 Builder 加价和接受的计费条款。仅身份访问不授权支出。验证、模型授权、积分不足、费率限制和执行失败会返回结构化 error. 在超时或提交不确定后,请检查使用情况或视频任务,然后再创建另一个可能付费的请求。.

最近更新日期:2026年11月3日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI