全部文章

一个 Key 调用所有国产模型:OpenAI 兼容接入实战

· 实战· API· OpenAI兼容

如果你的代码已经在用 OpenAI SDK,那么不用重写任何东西就能调用所有主流国产模型。诀窍是一个 OpenAI 兼容网关:请求格式一样,你只改 base URL 和模型名。下面是真实的接入套路。

接入

Turiloop 创建一个 Key,然后把任意 OpenAI SDK 指到网关:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TURILOOP_API_KEY"],
    base_url="https://api.turiloop.com/v1",
)

接入到此结束。下面所有示例都用这一个 client。

能调用的模型

同一个 Key 全部可达,改 model 字段即可切换:

  • glm-5.2:当前开源权重第一(深度拆解),glm-5.1 作为更省的日常档。
  • deepseek-v4-pro / deepseek-v4-flash:旗舰推理和代码,以及极便宜的快速档。
  • kimi-k2.6 / kimi-k2.5:月之暗面的长上下文 agent。
  • minimax-m2.5:性价比通用档。
  • claude-opus-4-8 / claude-sonnet-4-6:闭源前沿,同一个 Key。

切换模型只需一行

def ask(model: str, prompt: str) -> str:
    r = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": prompt}],
    )
    return r.choices[0].message.content

print(ask("deepseek-v4-flash", "判断情绪:'物流好慢'"))
print(ask("deepseek-v4-pro", "用 Rust 写二分查找并带测试"))

流式

网关和 OpenAI 一样支持流式,设 stream=True 然后迭代增量:

stream = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[{"role": "user", "content": "解释 CAP 定理。"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

智能路由:默认走便宜的,需要时再升级

最大的省钱点是把大头流量路由给便宜模型,只在难的提示上升级。API 是统一的,路由非常简单:

def smart_ask(prompt: str, hard: bool = False) -> str:
    model = "deepseek-v4-pro" if hard else "deepseek-v4-flash"
    return ask(model, prompt)

V4-Flash 每千 token 只要零点几分钱,V4-Pro 也远低于闭源价。把 90% 流量给 Flash、10% 给 Pro,账单能比"全用前沿模型"省一个数量级。

用代码列出模型

curl https://api.turiloop.com/v1/models \
  -H "Authorization: Bearer $TURILOOP_API_KEY"

Node 同理

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TURILOOP_API_KEY,
  baseURL: "https://api.turiloop.com/v1",
});

const r = await client.chat.completions.create({
  model: "glm-5.2",
  messages: [{ role: "user", content: "你好" }],
});
const reply = r.choices[0].message.content; // the model's answer

就这么简单

一个 Key、一个 base URL、OpenAI 兼容。GLM-5.2、DeepSeek V4、Kimi K2.6、MiniMax 和 Claude,国际卡支付,按量计费。到 Turiloop 开始