芯剪开放平台上传文件
文件在本地、没有公网地址时，先传到我们这里拿一个地址。
语音识别只收地址。文件在你本地的话，分三步：
1. 申请上传地址
curl -X POST https://api.gomiservice.com/v1/uploads \
-H "Authorization: Bearer sk-gomi-你的Key" \
-H "Content-Type: application/json" \
-d '{ "filename": "meeting.mp3", "size": 5242880 }'{
"upload_url": "https://…上传地址…",
"upload_expires_at": 1791001800,
"url": "https://…读取地址…"
}| 字段 | 说明 |
|---|---|
size | 必填，文件的字节数，不超过 200 MB。上传时的实际大小必须跟它一致 |
filename | 可选，只用来取扩展名 |
upload_url | 把文件 PUT 到这里。30 分钟内有效（upload_expires_at） |
url | 传完之后拿它去提交，3 天内有效 |
2. 把文件 PUT 上去
curl -X PUT --upload-file ./meeting.mp3 "https://…上传地址…"- 直接传到存储，不经过接口服务，大文件也不会超时
- 返回 HTTP 200 即成功，响应体为空
- 实际上传的字节数必须等于申请时的
size，不一致会被拒（403，签名不匹配）。curl --upload-file会自动带上正确的长度 upload_url已经带了签名，不要再加Authorization头
3. 拿 url 提交
curl -X POST https://api.gomiservice.com/v1/audio/transcriptions \
-H "Authorization: Bearer sk-gomi-你的Key" \
-H "Content-Type: application/json" \
-d '{
"model": "volc-asr",
"audio_url": "https://…读取地址…",
"request_id": "asr-20261003-0002"
}'说明
- 申请地址不扣费，按提交时的识别时长计费
- 上传的文件只用于提交，3 天后自动删除，不要当长期存储用。传完请尽快提交
- 每个文件申请一次地址。提交之后不要再往同一个
upload_url覆盖内容：执行时读到的文件比提交时量的明显更长，任务会失败（点数退还） url在浏览器里打开是直接下载，不会在页面里播放或显示