OpenAI OSS Go 语言 API 教程：轻松调用 GPT-OSS-120B 与 GPT-OSS-20B

一句话总结：十分钟内，把 120B 推理怪兽 和 20B 轻量快刀 同时装进你的 Go 服务，成本砍到膝盖，性能飙到天花板。

🌌 为什么必须是 OpenAI OSS？

2025 年，大模型江湖出现“开源三幻神”：

OpenAI OSS 以 Apache 2.0 协议完全开源，MoE 架构 + RoPE + 128 K 上下文，官方直接放出 OpenAI-Compatible REST Endpoint，让 Go 开发者“开箱即用”。

🧭 全流程鸟瞰图

1️⃣ 选平台拿密钥（30 秒）

下文以 Novita AI 为例，步骤对 OpenRouter/Ollama 同样适用。

1.1 30 秒注册流程

1. 打开 Novita AI 控制台 → Sign in with Google/GitHub
2. Billing → Add Payment → 支持支付宝/微信/信用卡
3. API Keys → Create → 复制 sk-nov-***

2️⃣ go get sdk（60 秒）

go get github.com/sashabaranov/go-openai

官方兼容格式，一行搞定。

3️⃣ 20B 本地跑通（60 秒）

3.1 Ollama 一键拉起

# 安装
curl -fsSL https://ollama.ai/install.sh | sh
# 拉取 20B
ollama pull gpt-oss:20b
# 启动
ollama serve

3.2 Go 调用示例

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    openai "github.com/sashabaranov/go-openai"
)

func main() {
    client := openai.NewClientWithConfig(openai.ClientConfig{
        BaseURL: "http://localhost:11434/v1",
        APIKey:  "ollama",
    })

    req := openai.ChatCompletionRequest{
        Model: "gpt-oss:20b",
        Messages: []openai.ChatCompletionMessage{
            {Role: openai.ChatMessageRoleUser, Content: "写一段 Go 协程池示例"},
        },
        MaxTokens: 512,
        Temperature: 0.1,
    }

    resp, err := client.CreateChatCompletion(context.Background(), req)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

运行：

go run 20b_local.go

终端输出：

package main

import (
    "context"
    "fmt"
    "sync"
    "time"
)

func main() {
    pool := make(chan func(), 10)
    var wg sync.WaitGroup

    for i := 0; i < 5; i++ {
        wg.Add(1)
        task := func(id int) func() {
            return func() {
                defer wg.Done()
                fmt.Printf("Worker %d done\n", id)
            }
        }(i)
        pool <- task
    }

    go func() {
        for t := range pool {
            t()
        }
    }()

    wg.Wait()
    close(pool)
    time.Sleep(time.Second)
}

4️⃣ 120B 云端压测（60 秒）

4.1 Novita AI 云端配置

client := openai.NewClientWithConfig(openai.ClientConfig{
    BaseURL: "https://api.novita.ai/v3/openai",
    APIKey:  os.Getenv("GENIE3_API_KEY"),
})

req := openai.ChatCompletionRequest{
    Model: "openai/gpt-oss-120b",
    Messages: []openai.ChatCompletionMessage{
        {Role: openai.ChatMessageRoleSystem, Content: "你是架构师，请给出详细设计"},
        {Role: openai.ChatMessageRoleUser, Content: "设计一个支持千万并发的 IM 系统"},
    },
    MaxTokens: 2048,
    Temperature: 0.3,
}

4.2 压力结果

5️⃣ 流式打字机（60 秒）

stream, err := client.CreateChatCompletionStream(ctx, openai.ChatCompletionRequest{
    Model: "openai/gpt-oss-20b",
    Messages: []openai.ChatCompletionMessage{
        {Role: openai.ChatMessageRoleUser, Content: "讲个笑话"},
    },
    MaxTokens: 128,
    Stream: true,
})
for {
    resp, err := stream.Recv()
    if err == io.EOF {
        break
    }
    fmt.Print(resp.Choices[0].Delta.Content)
}

前端 WebSocket 一行：

ws.onmessage = e => document.body.insertAdjacentText("beforeend", e.data);

6️⃣ 函数调用（60 秒）

6.1 定义工具

type WeatherReq struct {
    City string json:"city"
}

var tool = openai.Tool{
    Type: openai.ToolTypeFunction,
    Function: &openai.FunctionDefinition{
        Name:        "get_weather",
        Description: "查询城市天气",
        Parameters: json.RawMessage(`{
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }`),
    },
}

6.2 调用流程

req := openai.ChatCompletionRequest{
    Model: "openai/gpt-oss-20b",
    Messages: []openai.ChatCompletionMessage{
        {Role: "user", Content: "北京天气如何？"},
    },
    Tools: []openai.Tool{tool},
}
resp, _ := client.CreateChatCompletion(ctx, req)
// 解析 resp.Choices[0].Message.ToolCalls

7️⃣ 上线 K8s（60 秒）

7.1 Dockerfile

FROM golang:1.22 AS builder
WORKDIR /app
COPY . .
RUN go build -o app main.go

FROM gcr.io/distroless/base
COPY --from=builder /app/app /app
ENV GENIE3_API_KEY=${GENIE3_API_KEY}
EXPOSE 8080
ENTRYPOINT ["/app"]

7.2 Helm Chart

# values.yaml
image:
  repository: your-registry/genie-go
  tag: latest
env:
  GENIE3_API_KEY: sk-nov-xxx
resources:
  limits:
    memory: "512Mi"
    cpu: "500m"

8️⃣ 常见错误速查

9️⃣ 一键复制仓库

git clone https://github.com/yourname/genie-oss-go-demo.git
cd genie-oss-go-demo
go run main.go

仓库包含：

• 20B 本地 + 120B 云端双模式
• 流式 + 函数调用示例
• Dockerfile & K8s Helm
• Prometheus 监控大盘

🎉 写在最后

从 20B 轻量快刀 到 120B 推理怪兽，再到 128 K 超长上下文，OpenAI OSS 把“大模型”这三个字的门槛踩成了地平线。
下一次，当产品经理问你“能不能让 AI 自己写 CI/CD 脚本”时，你可以微笑着说：

“给我 10 分钟，Go 搞定。”