AI 音频
语音转文字
音频转写为文字(Whisper),返回文本、分段与语言
把一段音频异步转写为文字,返回全文、分段时间轴与识别语言。提交后用返回的 task_id 轮询。
Base URL:
https://api.aiclonevoicefree.com| 鉴权:Authorization: Bearer sk_...
POST /api/v2/voice/transcribe
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
audio_url | string | ✅ | 音频 URL(也接受别名 url) |
duration_seconds | number | ✅ | 音频时长(秒),用于按秒计费 |
language | string | ⬜ | 语言代码,留空自动检测 |
计费
按音频时长 1 积分/秒(
cost = 向上取整(duration_seconds))。提交时预扣并校验余额,不足返回402;任务失败自动退款。
curl -X POST https://api.aiclonevoicefree.com/api/v2/voice/transcribe \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "audio_url": "https://your-cdn.com/speech.mp3", "duration_seconds": 42 }'响应 202 → { "task_id": "...", "status": "pending", "capability": "voice", "action": "transcribe" }
取结果
轮询 GET /api/v2/voice/transcribe/{task_id}(注意:转写有专属状态端点,不走统一的 /tasks):
{
"task_id": "...",
"status": "completed",
"capability": "voice",
"action": "transcribe",
"_type": "voice.transcribe",
"text": "完整转写文本……",
"language": "zh",
"segments": [{ "start": 0.0, "end": 3.2, "text": "……" }]
}