集成示例

curl

查看模型列表

curl -H "Authorization: Bearer %VILAB_API_KEY%" ^
  http://192.168.1.24:8765/v1/models

转录音频

curl -X POST ^
  -H "Authorization: Bearer %VILAB_API_KEY%" ^
  -F "file=@sample.wav" ^
  -F "model=vilab-stt-default" ^
  http://192.168.1.24:8765/v1/audio/transcriptions

TypeScript

const form = new FormData();
form.append('file', new Blob([audioBytes]), 'clip.wav');
form.append('model', 'vilab-stt-default');

const response = await fetch('http://192.168.1.24:8765/v1/audio/transcriptions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VILAB_API_KEY!}`,
  },
  body: form,
});

if (!response.ok) {
  throw new Error(await response.text());
}

const data = await response.json();
console.log(data.text);

Python

import os
import requests

with open("sample.wav", "rb") as audio_file:
    response = requests.post(
        "http://192.168.1.24:8765/v1/audio/transcriptions",
        headers={"Authorization": f"Bearer {os.environ['VILAB_API_KEY']}"},
        files={"file": ("sample.wav", audio_file, "audio/wav")},
        data={"model": "vilab-stt-default"},
        timeout=60,
    )

response.raise_for_status()
print(response.json()["text"])

集成规则

• 业务调用使用 external API key，不使用 adminKey
• 一把 key 只给一个集成方
• 对外暴露时优先使用稳定的主机名或固定局域网 IP