一句话结论
“OpenAI Compatible”通常表示部分请求格式可以复用，但不代表 Chat Completions、Responses API、工具调用、图像、视频和 Anthropic Messages 全部兼容。
接口能力矩阵
| 能力 | 常见用途 | 验证重点 | 不能仅凭什么判断 |
|---|---|---|---|
| Chat Completions | 对话、文本生成 | messages、model、流式返回 |
/v1/models 成功 |
| Responses API | Codex、工具任务、统一响应事件 | 事件结构、工具调用、输出解析 | Chat 请求成功 |
| Anthropic Messages | Claude Code、Claude 客户端 | Anthropic 路径、请求头、消息结构 | OpenAI 地址可用 |
| SSE 流式输出 | 实时显示生成内容 | text/event-stream、代理缓冲、断流 |
非流式请求成功 |
| 工具调用 | Agent、函数调用、工作流 | 参数结构、工具结果回传、多轮状态 | 普通文本回答正常 |
| Embedding | 检索、向量库、RAG | 向量维度、批量输入、模型类型 | 聊天模型存在 |
| 图像接口 | 文生图、图片编辑 | 请求字段、输出 URL/Base64、尺寸 | 多模态聊天可用 |
| 视频接口 | 视频生成与任务轮询 | 异步任务、状态查询、结果下载 | 图像接口可用 |
建议的验证顺序
1. 验证认证和模型列表
curl https://www.aifast.hk/v1/models \
-H "Authorization: Bearer $API_KEY"2. 验证最小 Chat 请求
curl https://www.aifast.hk/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从模型列表复制的真实模型ID",
"messages": [{"role": "user", "content": "只回复 OK"}]
}'3. 单独验证目标客户端需要的能力
- Codex：重点验证 Responses API 和工具事件。
- Claude Code：重点验证 Anthropic Messages 入口和认证变量。
- Dify：验证所选模型类型、凭据和工作流节点。
- OpenWebUI、Chatbox、Cherry Studio：验证 Base URL 自动拼接和模型 ID。
- Agent：单独测试工具调用、长任务、超时和失败恢复。
上线判断标准
只有目标业务真实使用的能力全部通过，才能判断该接入适合生产。建议保存：
- 最终请求 URL 和状态码。
- 响应
Content-Type。 - 请求 ID 或错误正文。
- 实际模型 ID。
- 客户端版本和配置方式。
- 流式、工具调用和超时测试结果。