转录音频
在 input_audio.data 中提供 base64 音频及其实际格式。.
本页面内容
https://api.shareai.now/api/v1/audio/transcriptions转录音频
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
- 必需范围
inferenceormonetization_gateway
在中提供 base64 音频 input_audio.data 及其实际 format. 支持的语言、提示、响应格式和时间戳选项取决于模型。此 JSON 端点不接受多部分文件上传。响应包含转录内容和报告的使用情况。.
开始之前#
在您的服务器上设置 SHAREAI_API_KEY,并将模型占位符替换为当前启用的模型。切勿在浏览器代码中暴露 API 密钥。模型、账户、凭证和提供者必须全部允许此操作。以下可选设置需要模型支持;API 安全范围并不保证每个模型支持所有值。.
发送请求#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);示例包含一个微小的静音 WAV,仅用于展示有效的 base64 传输。将 input_audio.data 替换为您自己的音频文件的标准 base64;对于 Python,请使用 base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”)。不要将音频 URL 粘贴到此字段中。.
请求字段#
| 字段 | 类型 | 含义与限制 |
|---|---|---|
model 必需 | 字符串 | 精确启用的公共模型标识符。必须声明此操作并由您的凭证允许。. |
input_audio 必需 | 对象 | 所需数据和格式字段。data 是实际音频字节的标准 base64;格式必须匹配。仅支持 JSON;不支持多部分。时长计费需要 WAV、MP3 或 FLAC,且需具有已知时间基,最长合计 600 秒。. |
language | 字符串 | 可选的模型支持语言代码。. |
prompt | 字符串 | 可选的模型支持转录上下文;不是音频生成提示。. |
response_format | 字符串 | 模型支持的响应格式,最多 100 个字符。操作决定结果是 JSON 还是二进制。. |
timestamp_granularities | 数组 | 可选的模型支持时间戳粒度值。可用性取决于响应格式和模型。. |
provider | 对象 | 可选的提供者路由偏好。使用 provider.only 接受的提供者标签,而不是模型 ID 的前缀。账户和凭证限制仍然适用。. |
阅读结果#
成功返回 HTTP 200 和 JSON。在中提供 base64 音频 input_audio.data 及其实际 format. 支持的语言、提示、响应格式和时间戳选项取决于模型。此 JSON 端点不接受多部分文件上传。响应包含转录内容和报告的使用情况。.
计费单位#
转录使用模型发布的时长和/或令牌计费。提供者报告的秒数和令牌是独立的测量值。Base64 长度不是音频时长或令牌计数。输入时长计费需要自描述的 WAV、MP3 或 FLAC,合计时长最多 600 秒;未知或原始 PCM 时间基不被接受用于时长定价。.
从控制台选择精确启用的模型标识符。其声明的操作和输入/输出能力必须与此端点匹配;文本聊天模型不能替代其他操作。您的凭证、提供者和账户限制仍然适用。.
定价与使用#
费率以选定模型、提供者、单位和变体的 EUR AI 积分发布。仅收费于其活动费率中的维度。估算会在执行前保留积分;最终费用使用测量的使用量。价格可能取决于分辨率、输出格式或使用范围。请检查控制台使用情况以获取最终的 ShareAI 扣款。上游成本字段和媒体字节不会转换为虚构的令牌计数。.
访问与错误#
使用 inference 用于批准的网络成本推理或 monetization_gateway 用于批准的 Builder 加价和接受的计费条款。仅身份访问不授权支出。验证、模型授权、积分不足、费率限制和执行失败会返回结构化 error. 在超时或提交不确定后,请检查使用情况或视频任务,然后再创建另一个可能付费的请求。.
最近更新日期:2026年11月3日