文档目录

用官方 SDK

OpenAI / Anthropic / Gemini / 方舟 / 百炼 / 可灵 / 即梦 的 base url 怎么填,以及那个会被吃掉的 /v1。

内容最后核对:2026-11-18

本页目录

原则:不发明新客户端

把 base url 换成网关地址,其余一行都不用改。 包括厂商自己发的 SDK —— 它们拼出来的原生路径我们也挂了一份。

主流 SDK 怎么配

SDKbase url密钥位置
OpenAI(Python / Node / Go)<网关地址>/v1Authorization: Bearer
Anthropic<网关地址>/v1x-api-key(也认 Bearer)
Gemini<网关地址>/v1betax-goog-api-key 或 ?key=
火山方舟<网关地址>/v1Authorization: Bearer
阿里百炼<网关地址>/v1Authorization: Bearer
MiniMax<网关地址>/v1Authorization: Bearer
可灵<网关地址>Authorization: Bearer(路径自带 /kling)
即梦<网关地址>Authorization: Bearer(路径自带 /jimeng)
# OpenAI 官方 SDK:文本、图像、语音、Sora 视频
from openai import OpenAI

client = OpenAI(api_key="sk-ag-...", base_url="<网关地址>/v1")

client.chat.completions.create(model="<模型名>",
                               messages=[{"role": "user", "content": "你好"}])
client.images.generate(model="<图像模型>", prompt="一只橘猫", n=1)
client.audio.speech.create(model="<TTS 模型>", voice="alloy", input="你好")
client.videos.create(model="<视频模型>", prompt="一只橘猫在窗台上", seconds="5")
// Node
import OpenAI from 'openai';

const client = new OpenAI({ apiKey: 'sk-ag-...', baseURL: '<网关地址>/v1' });
const reply = await client.chat.completions.create({
  model: '<模型名>',
  messages: [{ role: 'user', content: '你好' }],
});

那个会被吃掉的 /v1

有些 SDK 会把 base 里的 /v1 吃掉:火山 Java SDK 用 scheme / host / port 三段重建 URL, 于是真实请求是 /api/v3/... 而不是 /v1/api/v3/...。

所以同一组厂商原生路径在站点根上也挂了:

<网关地址>/v1/api/v3/contents/generations/tasks   ← base 带 /v1
<网关地址>/api/v3/contents/generations/tasks      ← base 是站点根

两条都能通。遇到 404 先看真实请求路径(抓包或 SDK 日志),再对照 视频 API 的原生路径表。

用 Anthropic SDK 打本网关

from anthropic import Anthropic

client = Anthropic(api_key="sk-ag-...", base_url="<网关地址>/v1")
msg = client.messages.create(
    model="<模型名>",
    max_tokens=256,
    messages=[{"role": "user", "content": "你好"}],
)

错误信封会带顶层 {"type":"error"}(Anthropic 协议要求),SDK 能正常解析。 注意 max_tokens 在 Anthropic 协议里必填。

用 Gemini SDK

from google import genai

client = genai.Client(api_key="sk-ag-...",
                      http_options={"base_url": "<网关地址>"})
resp = client.models.generate_content(model="<模型名>", contents="你好")

Gemini SDK 自己在 base_url 后面拼 /v1beta/models/...,所以 base 写站点根。

SDK 报「解析失败」时先看信封

不同路径的错误信封不同(见约定与错误码):

  • /v1/**:OpenAI 嵌套。
  • /kling/**:{code, message, request_id, data},码是数值。
  • /jimeng*:{code:10000, data, message, status}。
  • /v1/messages:顶层 {"type":"error"}。

如果 SDK 报的是「unexpected token」「missing field」,先把原始响应体打出来 —— 九成是把厂商路径的响应按 OpenAI 形状解析了,或者反过来。

不支持的东西

  • 不实现 SDK 的重试逻辑:重试策略是你的(见超时、重试与幂等)。
  • 不接管 SDK 的流式解析:SSE 帧按各家协议原样发,不重写。
  • 不模拟厂商的完整 API:只提供本站支持的那部分端点。SDK 里其它方法(文件、微调、批处理)在这里不可用。