BEEOS CLOUD / DEVELOPER REFERENCE

音频

音频转写。

概览

audio domain 把音频转写为文字。

1 个操作 · SDK 资源：TypeScript cloud.audio · Python cloud.audio · Go cloud.Audio · API 总览

主要对象

audio.transcribe 接收上传的音频并返回转写文本；其字段列在该方法下。

典型流程

用 audio.transcribe 发送音频，并从响应中读取转写文本。

方法

方法	HTTP	摘要
audio.transcribe	`POST /v1/audio/transcribe`	转写音频

audio.transcribe

POST /v1/audio/transcribe · Operation ID transcribeAudio

转写音频

SDK 方法

语言	方法	签名
TypeScript	`cloud.audio.transcribe`	`transcribe(input: Models.TranscribeAudioRequest): Promise<Models.TranscribeAudioResponse>`
Python	`cloud.audio.transcribe`	`def transcribe(self, input: TranscribeAudioRequest) -> TranscribeAudioResponse`
Go	`cloud.Audio.Transcribe`	`func (r *AudioResource) Transcribe(ctx context.Context, input TranscribeAudioRequest) (TranscribeAudioResponse, error)`

请求体

multipart/form-data · 必填

字段	类型	必填	说明
`file`	`string`	是	约束: `format=binary`.

响应

200 · application/json

字段	类型	必填	说明
`success`	`boolean`	是	—
`data`	`object`	是	—
`data.text`	`string`	是	—
`data.duration_seconds`	`number`	是	—

错误

状态码	Schema	说明
其他（default）	ErrorResponse	Cloud Server 错误

错误 schema 见错误。

示例

import { BeeOSClient } from "@beeos-ai/cloud-sdk";

const cloud = new BeeOSClient({
  baseURL: "https://api.cloud.beeos.ai/v1",
  apiKey: "YOUR_API_KEY", // bsk_ key: backend only
});
const result = await cloud.audio.transcribe({ file: new Blob(["example"]) });
console.log(result);

BeeOS Cloud返回文档首页