01 定义02 通道03 压缩04 边界05 验证
Integration workbench

把模型接进来，只需要改三个地方ONE KEY · FOUR PROTOCOLS · SAME BASE URL

鉴权头、消息结构、返回解析——协议之间的差异全部集中在这三处。网关同时提供 OpenAI、Anthropic、Gemini 与媒体四套通道，模型 ID 不变，base_url 只有一个。

看四协议对照取一个 Key
curl
# 换 base_url 与 model，原有 SDK 直接可用
curl https://api.lk888.ai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"hi"}]}'

01 / 四套通道

同一个 Key，四种写法

端点、鉴权头、模型 ID 三者互相独立。换通道不用换 Key，也不用换账号。

POSTOpenAI
/v1/chat/completions

Bearer 鉴权。生态最广，OpenAI SDK、LiteLLM、各类框架默认走这条。站内收录 8 个模型使用。

POSTAnthropic
/v1/messages

x-api-key + anthropic-version: 2023-06-01。长上下文与原生工具块在这条通道上最省事。站内 3 个模型。

POSTGemini
/v1beta/models/{model}:generateContent

x-goog-api-key，模型名写在路径里。站内 5 个模型走这条。

POST/GETMedia
/v1/media/generate
/v1/media/status?task_id=

图片与视频是异步任务：先提交拿 task_id，再按退避轮询取结果。站内 32 个模型。

02 / MCP 接入

第一个工具，四个动作

MCP 的价值不在协议本身，而在把工具变成可被模型稳定发现、调用、复用的标准件。右侧编号对应步骤，不是装饰。

01

先把工具描述写对

名字用动词短语，描述写清「什么时候该用」，参数逐个给类型与范围。描述里不写实现细节。

02

选一条调用通道

同一把 Key 同时具备四套协议，聊天走 chat/completions，需要原生工具块走 messages，媒体走两步异步。

03

把返回压缩到可读长度

工具原始返回常是几十 KB，先裁字段、再摘要，最后才进模型。这一步决定输入 token 会不会翻倍。

04

给调用装边界

单轮最多调用几次、单次返回字符上限、失败降级路径。三条都要有默认值。

05

验证

模型能否自主选中工具、参数填错时会不会自修一次、工具超时后整轮是否仍可作答。

03 / 三个高频坑

上线前后最容易踩的地方

系统提示词塞进 messages

Anthropic 协议要求系统提示词在顶层字段，塞进首条消息会静默失效。

长任务用同步等结果

图片视频必须按 task_id 轮询，同步等待只会拿到超时。

无上限重试

429 与 5xx 可以重试，4xx 不该重试——重试只是重复失败并计费。

04 / 接入笔记

每篇解决一个具体问题

全部 5 篇

2026-11-12 · 工具调用 / 重试工具调用的失败重试：怎么让 Agent 不重复扣费Agent 最容易把账单推高的地方不是模型贵，而是失败重试。这篇给出三条规则：幂等键、状态机、一次只允许一个在途调用。2026-11-12 · 流式输出 / 超时流式输出断了怎么办：断流、超时与补全流式输出让首字更快，也让失败处理变复杂：已经吐出的部分要不要重来、超时按谁算、前端怎么续。这篇给出可用的一套处理约定。2026-11-12 · 协议兼容 / 迁移把 Anthropic 的调用改成 OpenAI 兼容只需要改三处同一个网关同时提供 OpenAI、Anthropic、Gemini 与媒体四套协议。这篇说明迁移时真正需要改的三处：鉴权头、消息结构、返回解析。2026-11-12 · 媒体模型 / 异步任务媒体任务的提交与查询：图片视频接入的正确姿势图片和视频的生成不是同步接口，而是「提交 — 查询 — 取结果」的两步流程。这篇把提交、轮询、回调、失败处理四段讲清楚。