文档

音频转录

把音频转成文字,保留原来的语言。会议记录、字幕与语音指令转写用这个接口。

POST https://open.feiyutoken.com/v1/audio/transcriptions

请求参数

请求体是 multipart/form-data(上传音频文件),不是 JSON。

参数 类型 必填 说明
file file 是 要转录的音频文件。支持的容器与编码格式取决于模型
model string 是 转录模型;可用值见模型列表
language string 否 音频语言的 ISO-639-1 代码;不传时由模型自行判断
prompt string 否 提示词,用来引导术语与专有名词的写法
response_format string 否 返回格式,可取值 json、text、srt、verbose_json、vtt;默认 json
temperature number 否 采样温度
timestamp_granularities(配合 verbose_json 使用) array 否 时间戳粒度,可取值 word、segment

请求示例

curl https://open.feiyutoken.com/v1/audio/transcriptions \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -F model="<模型名>" \
  -F file="@./meeting.mp3" \
  -F language="zh" \
  -F response_format="json"

用 -F 上传时不要手写 Content-Type —— curl 会自己带上 multipart 的 boundary, 手写反而会让服务端解析失败。文件参数必须用 @ 指路径。

响应

response_format 为 json(默认)时:

{
  "text": "转录出来的完整文本。"
}

改成 text、srt、vtt 时,响应体直接是对应格式的文本,不再包在 JSON 里; verbose_json 则在 JSON 里带上更多字段。

计费与用量

按字符数或时长计费(与模型厂商官网一致),费用从账户余额扣减。调用记录与消费明细在控制台可以按模型、 按 Key、按时间查看。