大模型供应商API端点兼容协议

gsls2008082026-08-01 9:23

各家大模型供应商为了兼容各种AI工具，基本上都会支持几种广泛使用的API兼容协议

一、常见的兼容协议

1.OpenAI Chat Completions(v1/chat/completions) 协议

测试请求

复制代码 
curl --location 'https://open.example.com/v1/chat/completions' \
--header 'Authorization: Bearer sk-aaabbb' \
--header 'Content-Type: application/json' \
--data '{
    "model": "GLM-5.2",
    "messages": [
      {"role": "user", "content": "hello"}
    ],
    "temperature": 0.2,
    "top_p": 0.9
  }'

返回示例

复制代码 
{
    "id": "5aa825e5-3yud-4il0-bfhj-c619c3c39367",
    "object": "chat.completion",
    "model": "glm-5.2",
    "created": 1785480756,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好！我是Z.ai训练的GLM大语言模型。很高兴能与你交流。\n\n有什么我能帮助你的问题或者你想了解的话题吗？无论是工作学习上的疑问，还是日常生活中的好奇，我都很乐意为你提供帮助。",
                "reasoning_content": "Let me consider how to respond to this greeting thoughtfully.\n\nThe user has started with a simple \"hello\" - this is likely the beginning of a conversation. I should respond in a way that's both welcoming and open-ended.\n\nFirst, I'll acknowledge their greeting warmly. Then I should introduce myself briefly to establish context. Since this is an initial interaction, I should also express my willingness to help while inviting them to share what's on their mind.\n\nI need to make sure my response feels natural and conversational, not overly formal or robotic. It would be good to end with an open question that encourages them to continue the dialogue.\n\nThe key is to create a friendly atmosphere where they feel comfortable sharing what they need assistance with. This initial exchange sets the tone for our entire conversation, so it's important to get it right.\n\nLet me craft a response that's welcoming, informative, and encourages further conversation."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 13,
        "completion_tokens": 232,
        "total_tokens": 245,
        "prompt_tokens_details": {
            "cached_tokens": 0
        },
        "completion_tokens_details": {
            "reasoning_tokens": 183
        }
    }
}

协议由美国 OpenAI 公司原生开发，2023 年 3 月，伴随 gpt-3.5-turbo 上线，替代老式单轮 /v1/completions

2.Anthropic Messages(v1/messages)协议

请求示例

复制代码 
curl --location 'https://open.example.com/v1/messages' \
--header 'x-api-key: sk-aaabbb' \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
    "model": "GLM-5.2",
    "max_tokens": 100,
    "temperature": 0.2,
    "top_p": 0.9,
    "messages": [
      {"role": "user", "content": "hello"}
    ]
  }'

协议由由美国 Anthropic 公司原生独立设计开发，正式发布时间：2023 年 6 月（API 版本头 anthropic-version: 2023-06-01）

✅ 最早应用模型：Claude 2 / Claude 2.1

推出目的：替代老旧字符串 prompt 接口，支持结构化多轮对话、区分 user/assistant 消息轮次；

架构关键设计：system 独立顶层字段，不塞进 messages 数组；强制消息交替 user ↔ assistant；max_tokens 为必填项。

3.OpenAI Responses API（/v1/responses）协议(CodeX使用)

复制代码 
curl --location 'https://open.example.com/v1/responses' \
--header 'Authorization: Bearer sk-aaabbb' \
--header 'Content-Type: application/json' \
--data '{
    "model": "GLM-5.2",
    "input": [
        {
            "role": "user",
            "content": "hello"
        }
    ],
    "temperature": 0.2,
    "top_p": 0.9
}'

协议由美国 OpenAI 独立原生开发，定位：OpenAI 面向智能体 (Agent) 场景的新一代官方 REST 协议，正式发布：2025-03-11，OpenAI 官方对外推出 /v1/responses，设计目标替代老旧 Beta 版 Assistants API，并作为 Chat Completions 的下一代演进接口。最早应用新版 Codex 云编码智能体（codex-1）

二、各厂商兼容情况

各厂商和中转站（采用new-api、CCX、TokenHub等开源组件搭建）基本上都支持前两种，少量情况也会支持第三种

比如稀宇科技minimax的官方文档里提到了支持三种，智谱AI的官方文档提到了支持前两种

三、各编码工具对接情况

1.claude命令行工具

修改配置文件 C:\Users\用户名\.claude\settings.json

内容如下

复制代码 
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-aaabbb",
    "ANTHROPIC_AUTH_TOKEN": "sk-aaabbb",
    "ANTHROPIC_BASE_URL": "https://open.example.com",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-5.2",
    "ANTHROPIC_MODEL": "GLM-5.2",
    "ANTHROPIC_REASONING_MODEL": "GLM-5.2"
  }
}

2.vscode

安装claude code for vscode插件

配置同上

3.jetbrain idea

安装 proxyAI插件 只能对话，不能直接修改代码

配置导入

CustomOpenAiSettings.json

内容

复制代码 
[{"name":"customendpoint","template":"OPENAI","apiKey":"","chatCompletionSettings":{"url":"https://open.example.com/v1/chat/completions","headers":{"Authorization":"Bearer $CUSTOM_SERVICE_API_KEY","X-LLM-Application-Tag":"proxyai","Content-Type":"application/json"},"body":{"stream":true,"model":"GLM-5.2","messages":"$OPENAI_MESSAGES","temperature":0.2,"max_tokens":8192}},"codeCompletionSettings":{"codeCompletionsEnabled":true,"parseResponseAsChatCompletions":true,"infillTemplate":"OPENAI","url":"https://open.example.com/v1/chat/completions","headers":{"Authorization":"Bearer $CUSTOM_SERVICE_API_KEY","X-LLM-Application-Tag":"proxyai","Content-Type":"application/json"},"body":{"suffix":"$SUFFIX","stream":true,"model":"GLM-5.2","temperature":0.2,"prompt":"$PREFIX","max_tokens":1024}}}]

目前idea插件2023版没找到能自由兼容通用api的

4.trae IDE

基于vscode的编码ide 自带免费模型，可以直接修改代码，2026.7.31改成每月免费500积分了

点击 右上角齿轮 进入设置页面

点击 模型--添加模型

点击 自定义配置 设置如下

复制代码 
API格式：Anthropic Message格式
自定义请求地址：https://open.example.com
模型ID: GLM-5.2
API密钥: 你的密钥

TRAE任务栏 模型选择关闭auto-mode 改成刚才定义的GLM-5.2

目前trae支持 OpenAI Chat Completions(v1/chat/completions) 协议和Anthropic Messages(v1/messages)协议

5.Zcode

交互式编程助手 类似codex 可以编码，也可以通过技能实现写ppt word

可以在不登录的情况下配置自定义模型

点击右下角齿轮-模型设置-添加供应商

设置如下

复制代码 
名称 customendpoint
baseurl https://open.example.com
api key 你的api key
api格式 Anthropic Message格式

添加模型 模型id填入 GLM-5.2

返回工作区即可使用刚才配置的模型id了

zcode支持 OpenAI Chat Completions(v1/chat/completions) 协议和Anthropic Messages(v1/messages)协议

6.Hermes Agent

由 Nous Research 开发，Github 高星自进化 AI Agent 工具

核心能力：闭环自我学习，自动把重复工作提炼为可复用 Skill 技能，后续任务提速 40%；

内置长效记忆系统，自动清理无用对话、留存长期规则；

自定义endpoint支持：OpenAI Chat Completions(v1/chat/completions) 协议、Anthropic Messages(v1/messages) 协议 和 OpenAI Responses API（/v1/responses）协议(Codex使用)

交互式命令切换模型

复制代码 
hermes model

填写 如下

复制代码 
Select provider: 选择 (○) Custom endpoint (enter URL manually)
API base URL [e.g. https://api.example.com/v1]: https://open.example.com/v1
API key [optional]: 你的api key
Select API compatibility mode: 选择2 Chat Completions
Available models: 选择2 GLM-5.2
Context length in tokens:  设置上下文长度 直接回车自动检测即可
Display name:  回车

使用

命令行

复制代码 
hermes

切换模型

复制代码 
hermes model

7.Netcatty

Netcatty 是一款跨平台的ssh工具，支持接入OpenAI Chat Completions协议的模型

设置-AI-提供商-添加提供商

复制代码 
显示名称：customendpoint
API key: 你的api key
Base URL : https://open.example.com/v1
默认模型 ：GLM-5.2

保存后点击启用

在连接主机后 点击右上角AI按钮 可以通过对话使用

最新版本的Netcatty已经支持 OpenAI Chat Completions(v1/chat/completions) 协议和Anthropic Messages(v1/messages)协议 额外支持google gemini协议

相关推荐
VIP_CQCRE10 小时前
用 Ace Data Cloud 接入 Suno 声音克隆 API：让 AI 音乐生成拥有专属人声
aigc·api·suno·ai音乐·ace data cloud
SQDN12 小时前
Cline 配置 OpenAI Compatible 前怎么验证？先查 Base URL、/models 与模型 ID
openai·api·baseurl·cline·模型调试
小白跃升坊13 小时前
倒反天罡！DeepSeek V4-Flash 正式版悄然上线：130亿激活参数，把自家1.6万亿旗舰「以下克上」
ai·大模型·agent·deepseek·v4
才鲸嵌入式17 小时前
JEPA具身智能或自动驾驶路线的公司
人工智能·机器学习·大模型·自动驾驶·具身智能·通用人工智能·jepa
用户77833661321120 小时前
从 0 搭一个 SERP API + LLM Agent 端到端实战（2026年7月）
llm·api·agent
安逸sgr1 天前
ReAct 是什么？Thought、Action、Observation 分别代表什么？
人工智能·ai·大模型·agent·智能体
安逸sgr1 天前
Prompt 优化和微调有什么区别？什么场景优先用 Prompt？
人工智能·ai·大模型·prompt·agent·智能体
thesky1234561 天前
27届大模型岗面试准备（十一）：模型蒸馏与稀疏化——从软标签到结构化剪枝的压缩全景
面试·大模型·剪枝·知识蒸馏·模型蒸馏·稀疏化
pie_thn1 天前
基于端侧大模型的嵌入式 Skill 调度引擎实现智能业务生成的尝试
大模型·嵌入式·skill
热门推荐
01如何新建文件夹？ 电脑新建文件夹的4种方法02GitHub 镜像站点032026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片04国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）05AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路06AI科技热点日报 | 2026年07月01日072026上半年大模型全景技术解读：推理融合、Agent 爆发与多模态统一082026 年 AI 大模型 & AI 编程工具实战全总结092026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？10微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新