Skip to main content
GoModel 通过 SGLang 兼容 OpenAI 的 /v1 API 与其通信,并通过提供商透传暴露 SGLang 的原生端点。 包含斜杠的 Hugging Face 模型 ID 也可以正常使用,因为 GoModel 只在第一个斜杠处拆分带提供商限定的选择器。 请先启动 SGLang:
有关当前的启动选项和特定于加速器的选项,请参阅 SGLang 的 兼容 OpenAI 的 API 文档。

配置

这些示例假设 GoModel 运行在 Docker 中,而 SGLang 运行在宿主机上。如果两者运行在同一个 Docker 或 Kubernetes 网络中,请使用 SGLang 的服务名称。如果 GoModel 直接运行在宿主机上,请使用 http://localhost:30000/v1。

运行 GoModel

验证

GET /v1/models 返回以提供商名称为前缀的 SGLang 模型 ID,例如 sglang/Qwen/Qwen2.5-0.5B-Instruct。

多个 SGLang 实例

使用带后缀的环境变量,无需 YAML 即可注册多个实例:
这会注册 sglang 和 sglang-test。后缀会被转换为小写,下划线会变为连字符。

原生透传

透传默认启用。/generate 这类相对于根路径的 SGLang 端点,在发送时不会带上配置的 /v1 前缀:
对于本身包含 v1/ 路径段的 SGLang 端点(例如 /v1/rerank 或 /v1/tokenize),请保留该显式路径段:
GoModel 在转发前会移除客户端的认证信息,并在已配置时使用 SGLANG_API_KEY。

能力说明

  • Chat Completions、流式传输、模型列表、Responses 和嵌入使用 SGLang 兼容 OpenAI 的 API。
  • 嵌入和特定于模型的功能取决于 SGLang 加载的模型。
  • 原生的批处理、文件和已存储响应的生命周期接口尚未作为带类型的 GoModel 提供商能力暴露; 在已安装的 SGLang 版本支持的情况下,请使用透传。
最后修改于 2026年10月24日