转录 API

Name: SRTGen
Rating: 4.9 (10000 reviews)

提交媒体进行 AI 转录和项目创建。支持视频和音频文件。

POST/api/v1/transcribe

快速实现

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

请求参数

参数	类型	是否必填	描述
`file`	File	Yes	待转录的媒体文件 (Multipart)。支持格式：视频 (mp4, mov, avi, webm, mkv), 音频 (mp3, wav, m4a, flac)。最大 2GB。
`videoUrl`	String	No*	媒体的外部 URL (如果请求体中未提供文件，则此项必填)。
`name`	String	No	项目的自定义名称。
`languageCode`	String	No	源语言代码 (例如 'en-us')。如果省略，默认为 'auto' (自动检测)。
`filterProfanity`	Boolean	No	是否自动审查敏感词汇。默认为 false。
`disfluencies`	Boolean	No	是否包含语气词 (例如 '嗯', '啊')。默认为 false。
`medicalMode`	Boolean	No	针对医疗/医药音频优化的转录。默认为 false。

高级：URL + AI 设置

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

成功响应

成功的请求返回 200 OK 状态，包含项目和后台作业详情。

projectId项目的唯一标识符。
status'inProgress' (转录进行中)。
注意：额度将在转录流程完成后从您的余额中异步计算并扣除。

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

错误代码

状态	错误代码	描述
400	missing_file	在 'file' 或 'video' 字段中未找到文件。
400	unreachable_url	提供的 videoUrl 无法访问或返回错误。
400	invalid_parameter	其中一个参数 (例如 videoUrl) 格式错误。
400	file_read_failed	上传的文件无法读取或已损坏。
401	unauthorized	API 密钥缺失或无效。
403	insufficient_balance	您的额度不足以处理该时长的媒体。
403	storage_quota_exceeded	文件超过了您计划的剩余云存储配额。
413	payload_too_large	文件超过了系统绝对 2GB 的上传限制。
500	transcription_failed	无法启动转录作业 (AI 提供商故障)。
500	server_error	出错了，请稍后再试。

错误响应结构

{
  "success": false,
  "error": "insufficient_balance",
  "message": "您的项目需要 5 个额度，但您的余额为 2。"
}

本页面对您有帮助吗？