用官方 SDK
OpenAI / Anthropic / Gemini / 方舟 / 百炼 / 可灵 / 即梦 的 base url 怎么填,以及那个会被吃掉的 /v1。
内容最后核对:2026-11-18
本页目录
原则:不发明新客户端
把 base url 换成网关地址,其余一行都不用改。 包括厂商自己发的 SDK —— 它们拼出来的原生路径我们也挂了一份。
主流 SDK 怎么配
| SDK | base url | 密钥位置 |
|---|---|---|
| OpenAI(Python / Node / Go) | <网关地址>/v1 | Authorization: Bearer |
| Anthropic | <网关地址>/v1 | x-api-key(也认 Bearer) |
| Gemini | <网关地址>/v1beta | x-goog-api-key 或 ?key= |
| 火山方舟 | <网关地址>/v1 | Authorization: Bearer |
| 阿里百炼 | <网关地址>/v1 | Authorization: Bearer |
| MiniMax | <网关地址>/v1 | Authorization: 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 里其它方法(文件、微调、批处理)在这里不可用。