语音转文字（计时）
● 服务正常
按量计费
POST
语音大模型
录音、音频文件转文字，支持 mp3、wav。按音频时长计费，约 1.62 元/小时，最大支持 2 小时音频，可选返回 SRT 字幕。
POSThttps://api.vidtidy.cn/api/v1/asr-audio-time
鉴权：请求头 X-API-KEY: sk_live_…（也支持 key 查询参数）。
请求参数
| 名称 | 必填 | 类型 | 说明 |
|---|
audioUrl | 必填 |
string | 音频直链（mp3 / wav），需 URL Encode |
callbackUrl | 选填 |
string | 处理完成回调地址（可选） |
needSrt | 选填 |
boolean | 是否生成 SRT 字幕，默认 false |
返回参数
| 名称 | 类型 | 说明 |
|---|
data | string | 任务 id，用于「文案任务进度查询」轮询 |
cost | string | 本次扣费金额（元，4 位小数） |
balance | string | 扣费后账户余额（元） |
返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": "asr_4e77",
"cost": "0.0450",
"balance": "48.0250"
}
说明：异步接口。适合会议录音、播客、在线课程等长音频转写，完成后用《文案任务进度查询》取结果。
计费口径
| 项目 | 说明 |
|---|
| 计费方式 | 按媒体时长计费，向上取整到秒 |
| 我方单价 | 0.00045 元/秒 |
| 定价口径 | 所有价格已含接入、重试、对账与技术支持，无任何隐藏费用 |
| 预扣与退款 | 按秒/按字类接口在提交时预扣，业务失败时 全额自动退回，无需申请 |
| 免费接口 | 任务查询类接口永远免费，高频轮询不会产生费用 |
| 最低余额 | 余额不足以支付本次预扣时会直接返回 402，不会产生任何调用 |
时长怎么算：优先用请求里的 duration；不传则服务端用 ffprobe 探测；探测失败按 180 秒兜底预扣。探测到的实际时长若超过你传入的值，按实际值结算。
错误码
| code | 含义 | 处理建议 |
|---|
200 | 成功 | — |
-1 | 业务异常 | 见 msg。链接不支持 / 文件不可下载 / 时长超限最常见 |
401 | 密钥无效 | 检查请求头，或到控制台确认密钥未停用 |
402 | 余额不足 | 充值后重试，本次不扣费 |
429 | 频率超限 | 按 100 次/秒 退避 |
500 | 服务异常 | 平台波动，已自动退款 |
cURL
curl -X POST "https://api.vidtidy.cn/api/v1/asr-audio-time" \
-H "X-API-KEY: sk_live_你的密钥" \
-d "audioUrl=示例值" \
-d "callbackUrl=示例值" \
-d "needSrt=示例值"
Python
import requests
r = requests.post(
"https://api.vidtidy.cn/api/v1/asr-audio-time",
headers={"X-API-KEY": "sk_live_你的密钥"},
data={"audioUrl": "示例值", "callbackUrl": "示例值", "needSrt": "示例值"},
timeout=120,
)
print(r.json())Node.js
const body = new URLSearchParams({
"audioUrl": "示例值",
"callbackUrl": "示例值",
"needSrt": "示例值",
});
const res = await fetch("https://api.vidtidy.cn/api/v1/asr-audio-time", {
method: "POST",
headers: { "X-API-KEY": "sk_live_你的密钥" },
body,
});
console.log(await res.json());PHP
true,
CURLOPT_HTTPHEADER => ["X-API-KEY: sk_live_你的密钥"],
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(["audioUrl" => "示例值", "callbackUrl" => "示例值", "needSrt" => "示例值"]),
]);
$out = curl_exec($ch);
curl_close($ch);
echo $out;
