协议与主流工具适配
按工具选择真实支持的协议,区分格式兼容与模型能力。
更新日期
协议选择表
| 工具 / 客户端 | Base URL | 协议 | 验证边界 |
|---|---|---|---|
| OpenAI SDK | https://www.link42.ai/v1 | Chat Completions / Responses / JSON Images / Embeddings | 流式、工具、JSON 受模型能力约束;不宣称支持所有 OpenAI 云接口。 |
| Anthropic SDK / Claude Code | https://www.link42.ai/anthropic | Messages / count_tokens | 使用模型 API ID。工具、思考、缓存能力由路由与模型决定。 |
| Codex | https://www.link42.ai/v1 | Responses | 自定义 provider 的 wire_api=responses、env_key=LINK42_API_KEY;不要改成聊天协议。 |
| Gemini REST / configurable JS SDK | https://www.link42.ai/gemini | v1beta/models/...:generateContent (REST) | 必须选择 Gemini 支持路由;Google GenAI SDK 的自定义 Base URL 能力依版本与运行模式而异,不可把 REST 地址直接当成通用 SDK 配置。 |
| OpenClaw / other agents | https://www.link42.ai/v1 | 按工具文档选择 OpenAI 协议;技能可独立调用媒体。 | 更改配置前备份;不覆盖全局工具、安全或认证配置。 |
最小配置示例
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ['LINK42_API_KEY'], base_url='https://www.link42.ai/v1')
models = client.models.list()
# Select an authorized model before creating a billable request.import os
from anthropic import Anthropic
client = Anthropic(api_key=os.environ['LINK42_API_KEY'], base_url='https://www.link42.ai/anthropic')
# messages.create(model='AUTHORIZED_MODEL', max_tokens=1024, messages=[...])import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
apiKey: process.env.LINK42_API_KEY,
httpOptions: { baseUrl: "https://www.link42.ai/gemini", apiVersion: "v1beta" },
});
// ai.models.generateContent({ model: "AUTHORIZED_MODEL", contents: "Hello" })model_provider = "link42"
model = "AUTHORIZED_MODEL"
[model_providers.link42]
name = "LINK42"
base_url = "https://www.link42.ai/v1"
env_key = "LINK42_API_KEY"
wire_api = "responses"export ANTHROPIC_BASE_URL="https://www.link42.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$LINK42_API_KEY"
export ANTHROPIC_MODEL="AUTHORIZED_MODEL"
claude适配验收与排错
先读取授权目录
验证 Key、IP 白名单、模型授权与余额;网页可见不是当前账号可调用证明。
验证实际协议
分别测试普通回复、SSE 事件、工具调用和计费用量;成功的模型列表不等于成功生成。
保留错误证据
401 查认证;403 查授权;402 查余额/预算;429 查限流;no_account_available 查路由/开通。记录脱敏请求编号,不自动重放收费 POST。
- 网关保留协议所需错误形状和恢复标记,但会过滤敏感凭据;不保证原始上游错误体逐字透传。跨协议转换不等于所有供应商专用功能都能转换。