
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
一个轻量、性能导向的自动语音识别(ASR)推理服务器。以下是基于3080 Ti的初步性能数据:
| 模型 | 输入音频长度 | 实时倍数 |
|---|---|---|
| OpenAI Whisper Large v3 | 19分51秒 | 50x |
| https://huggingface.co/distil-whisper/distil-large-v2 | 19分51秒 | 78x |
健康检查接口,仅在服务器完全就绪时返回响应。
响应示例
json{ "status": "ok", "version": "0.0.2" }
语音转文字接口,接受音频文件下载链接。
请求示例
json{ "url": "https://example.com/audio.mp3" }
响应示例
json{ "text": "hello world", "chunks": [ { "timestamp": [0.0, 2.1], "text": "hello world" } ] }
所有配置通过环境变量实现:
| 名称 | 描述 | 默认值 |
|---|---|---|
HOST | 监听的主机地址 | * |
PORT | 监听的端口 | 8000 |
MODEL_ID | 使用的模型ID(参考https://huggingface.co/models?pipeline_tag=automatic-speech-recognition&sort=trending%EF%BC%89 | openai/whisper-large-v3 |
CACHE_DIR | 模型缓存目录 | /data |
FLASH_ATTENTION_2 | 是否启用Flash Attention 2(需设为1启用,仅特定镜像版本支持) | 无 |
BATCH_SIZE | 批处理大小 | 16 |
MAX_NEW_TOKENS | 生成 tokens 上限 | 128 |
CHUNK_LENGTH_S | 每个音频 chunk 的长度(秒) | 30 |
STRIDE_LENGTH_S | 滑动窗口步长(秒) | CHUNK_LENGTH_S / 6 |
bashdocker run -d -p 8000:8000 \ -e MODEL_ID=openai/whisper-large-v3 \ docker.xuanyuan.run/saladtechnologies/asr-api:latest
bashdocker run -d -p 8000:8000 \ docker.xuanyuan.run/saladtechnologies/asr-api:latest-openai-whisper-large-v3
bashdocker run -d -p 8000:8000 \ -e FLASH_ATTENTION_2=1 \ saladtechnologies/asr-api:latest-fa2
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务