OpenAI兼容API怎么接？先跑通Chat，再验证其他功能

从同平台Key、base_url与准确模型ID完成Chat Completions最小请求。区分聊天、Responses、流式、工具和图片能力，不把一种接口成功当作全面兼容。

全球顶尖大模型 · 一站式接入

通过 apizt 统一 API 网关，按任务选择模型，集中管理密钥、用量与费用。

请求链路示意：应用通过统一网关连接模型服务 — API 请求链路概念图，非产品界面

OpenAI兼容API通常允许继续使用OpenAI SDK，但Key、base_url和模型ID都要换成目标服务提供的值。先验证Chat Completions返回有效文字；Responses、流式、工具调用和视觉输入仍要分别确认端点与模型支持。

资料核对：2026-10-25。本次复核配置与官方依据；原有实测保留原日期、环境与范围，新增相邻实验单独标注。

查看本次实测步骤与结果

把文本、SSE与Responses分别验收

用真实本机模型运行独立Chat流式与Responses请求，保存delta、完成状态和各自结果；不以一种接口成功代替全面兼容。

2026-10-23 · OpenAI Node SDK真实HTTP与SSE → 本机Ollama；分别记录两个协议。

已取得下列真实结果；仍有内容质量或功能范围需要按本页检查项复核。

运行环境: node v24.14.0；ollama 0.40.9；openai 7.43.0；ai 7.0.130；@ai-sdk/openai-compatible 3.0.65

1. 准备可独立运行的SDK项目
解压练习包，按lock文件安装，使用本机11435服务与本地占位认证；不需要商业Key。
bash
```
cd sdk && npm ci
```
2. 把Chat流式跑到结束
发7+5短任务，逐块收集delta.content，记录所有finish_reason；收到第一块时还不能宣布任务完成。
bash
```
node run.mjs compatible ../openai-compatible-api/new-result.json
```
3. 再单独请求Responses
使用responses.create及input结构，保留output_text或实际错误；不用Chat的成功推断它也成功。
4. 核对各自输出与范围
下载结果包含chunk数量、完整正文和结束状态，以及Responses独立结果。结果有差异要保留，不能丢弃失败试次。
5. 再按项目需要增加其他能力
工具往返、视觉和结构化输出各有独立验收，本页只覆盖明确列出的两个请求；不承诺其他网关或型号全部兼容。

这次实际得到什么

SSE输出：7 + 5 = 12；块数 9；结束 ['stop']
Responses：COMPAT_LOCAL_OK
实际路径：[{"method": "POST", "path": "/v1/chat/completions", "status": 200, "elapsedMs": 2027}, {"method": "POST", "path": "/v1/responses", "status": 200, "elapsedMs": 1034}]
本API组真实发出2次非流式Chat探针，分别gemini-2.5-flash与gemini-2.5-flash-lite，均HTTP429（当前测试Key分组上游饱和）。以下共享该组探针，绝非本页另发调用；随后SSE、Vercel、n8n、图片请求均未发送。
严格只返回整数的断言失败：实际是“7 + 5 = 12”；SSE传输与stop完成不代表格式约束通过。

openai-compatible-api 本次实际执行报告 — 本次实际输出与验证边界的浏览器截图；这是本站整理的运行报告，不能当作原生产品界面或未执行模型的成功证据。

下载本页输入、脚本与执行记录查看本次执行记录页面下载步骤与验证边界

使用这份结果时注意

本批获授权使用既有测试Key，OpenAI SDK两次最小探针均HTTP429：当前测试Key分组上游饱和，随后停止。不能据此声称全站不可用；本地成功不能当作apizt上游或实扣成功。
本地Responses仅无状态；没有验证previous_response_id、商业模型工具调用或厂商内置工具。

检查接口协议与请求结构

2026-10-25 资料复核与操作补充

继续操作前，核对当前配置与执行范围

本页现有流式和Responses记录为2026-10-23本机协议实验；其中网关429属于同日共享探针。新增模型/SDK小样按各自回执展示，不由一次Chat成功推断其他能力。

原记录范围：OpenAI Node SDK真实HTTP与SSE → 本机Ollama；分别记录两个协议。下列相邻实验各有自己的日期、模型和产物，不替代本篇客户端或协议的原生验收。

先确定这次要接入什么

已安装Python与openai包，并确认要调用的具体服务商。
准备该服务商签发的API Key、其文档给出的Base URL和当前可调用的准确模型ID；官方OpenAI与其他网关凭据分开使用。
本页先验证Chat Completions文本请求；流式、工具调用、图片和Responses需要分别确认所选服务与模型支持。

一条可复制的Chat请求

先安装openai包，在服务端设置API_KEY、API_BASE_URL、API_MODEL；模型ID必须来自所选服务。此示例会请求模型，可能计费，并关闭SDK自动重试以便定位一次请求。

最小请求通过后按需扩展

流式: 结束事件、有效文本和错误处理；只收到第一段或HTTP 200
工具调用: 名称/参数及真实工具往返；只得到一次工具提案
图片输入: 正确图片内容结构与可见事实；只写了图片文件名
Responses: 目标端点及响应项解析；Chat Completions已成功

按协议接入，再检查业务结果

1
选定服务与Chat兼容模型，准备该平台Key、基础地址和准确模型ID。官方OpenAI的基础地址是https://api.openai.com/v1，自定义网关按其说明填写。
2
在独立环境安装OpenAI SDK。
terminal
复制后合并到自己的配置；请在本地安全设置真实凭据。
```
python3 -m pip install openai
```

在服务端环境设置API_KEY、API_BASE_URL和API_MODEL，然后运行最小Chat请求；请求可能计费。

first_chat.py

复制后合并到自己的配置；请在本地安全设置真实凭据。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API_KEY"],
    base_url=os.environ["API_BASE_URL"],
    max_retries=0, timeout=30.0,
)
r = client.chat.completions.create(
    model=os.environ["API_MODEL"],
    messages=[{"role": "user", "content": "只回复OK"}],
)
text = r.choices[0].message.content if r.choices else None
if not text:
    raise RuntimeError("没有有效回答，请读错误或请求记录")
print(text)

4
检查有效回答和错误正文，并在实际调用记录中核对。401先查凭据，404看最终端点与模型；不要直接把所有错误归为不兼容。
5
按任务逐项增加流式、工具、图片或Responses；每项用对应消息结构和验收，不承诺Chat成功自动覆盖全部能力。

核对本页配置字段与检查项

OpenAI 兼容接口：从一次聊天到完整验收：字段：https://api.apizt.com/v1/messages、api_key、tokenba_API_KEY、base_url — 本站绘制的内容说明图：从本页命令提取的配置字段示意；只展示关键行，完整命令按正文执行，真实 Key 留在自己的环境。
查看高清原图

OpenAI 兼容接口：从一次聊天到完整验收：检查项：finish_reason、call_id — 本站绘制的内容说明图：按本页请求、客户端或结果条件逐项核对；配置保存、命令预览和真实模型调用分别验收。
查看高清原图

根据项目选择下一步

第三方工具必须支持该网关的协议和自定义地址；逐项确认模型 ID、流式、工具调用与图片输入，不能仅凭“OpenAI 兼容”判断全部功能可用。

一次调用经过哪些环节

应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
apizt 网关
核对模型 ID、令牌分组和可用额度
模型返回结果
检查响应正文与后台用量记录

用一个小请求，确认接入成功

先发送一条短文本或一个简单任务，检查输出、调用记录和费用，再用于正式业务。

按报错查解决方法

响应包含有效结果: 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
日志与请求对得上: 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
原工具中也能重复完成: 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。

常见问题

OpenAI兼容是不是只换base_url？

不只。需要同时匹配目标平台Key、模型ID、端点和参数；原服务的模型名或凭据不能直接假定可用。

Chat成功为什么Responses仍报错？

它们是不同端点和消息结构。先查目标服务是否支持Responses，再使用对应请求与响应解析；不能仅改路径。

如何在不同模型之间切换？

先更换为目标平台支持的准确 model ID，再验证该模型的输入、流式、工具调用和输出格式。兼容 Chat 请求不代表所有能力和参数都完全一致。

支持流式输出吗？

需要目标模型、网关和 SDK 同时支持；先用最小 stream 请求验证事件结构、增量文本和结束状态，再接入前端。

OpenAI-compatible 是否同时支持 Responses 和 Chat Completions？

不能只根据兼容标签判断。分别检查 /v1/chat/completions、/v1/responses 的文档和当前模型支持情况，核对请求字段、返回格式、工具和流式事件。

OpenAI 兼容接口怎样验证工具调用？

提供一个最小工具定义，检查返回的工具名称、参数格式和调用 ID，再提交匹配的工具结果继续对话。不要用普通文本回复代替真实的 tool_calls 验收。

OpenAI 兼容是否代表所有功能都支持？

不代表。兼容需要具体到协议、模型、分组和参数；纯文本聊天通过后，仍需分别验证图片输入、流式、工具调用、结构化输出和其他端点。

Embedding 和 Rerank 已经实测了吗？

2026-10-08 的 apizt 实测中，text-embedding-3-small 经 POST /v1/embeddings 返回 6 个 1536 维向量，usage 为 139 tokens；3 个虚构商店问答的检索首条均匹配预期。qwen3-rerank 经独立 POST /v1/rerank 返回 results[].index 与 relevance_score。该结果只覆盖本次令牌、分组和请求，不能外推到其他模型、所有分组、长文本或完整知识库。后台费用列匹配到 Rerank 为 USD 0.000006；Embedding 显示 USD 0.000000，低于六位小数显示精度，精确金额未确认，不代表免费。

切换模型只改 model 就行吗？

同一协议且所需能力一致时，修改 model 是迁移的一步。还要复查上下文、输出上限、支持参数、工具字段、返回结构和价格；从 Chat 换到 Responses 或 Messages 需要适配请求与解析。

如何确认流式输出真的可用？

在实际部署环境发送一次所选模型的短流式请求，检查有效文本、结束事件和超时处理。不同协议不能共用同一套 SSE 解析假设；本地事件检查工具只检查已有文本，不验证线上可用性。

价格和一次测试的费用怎么看？

首页及详情页显示最低可用价格，其他分组到模型广场查询。最终费用以实际模型、分组、计费方式和后台记录为准；usage tokens 不能直接当作实扣金额。

把想用的模型，接入你的工具与应用

注册后创建 apizt API Key，选择客户端和模型，再生成接入配置。从一次简单请求开始，按实际用量付费。

创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。

注册获取 API Key 已有账号？创建 API Key 检查接口协议与请求结构先到模型广场看价格

继续阅读与操作

正在打开页面…

正在加载内容，请稍候。