OpenAI 兼容接口
SDKMAX 的核心设计目标之一，是让任何已经对接 OpenAI 接口协议的代码，只需替换 base_url 与 api_key 就能切换过来，无需重写业务逻辑。
diff
- base_url = "https://api.openai.com/v1"
+ base_url = "https://api.sdkmax.com/v1"
- api_key = "sk-openai-xxx"
+ api_key = "sk-sdkmax-xxx"即使 model 指向的其实是 Claude、Gemini、DeepSeek 等非 OpenAI 模型，请求/响应结构依然遵循 OpenAI 协议 —— 这层"翻译"由网关在内部完成。
已支持的兼容接口
| 接口 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions | POST | 对话补全，支持流式（stream: true）与函数/工具调用（Function/Tool Calling，视具体模型能力而定） |
/v1/completions | POST | 传统文本补全（Legacy） |
/v1/embeddings | POST | 文本向量化 |
/v1/images/generations | POST | 文生图，详见 图片 API |
/v1/images/edits | POST | 图片编辑/局部重绘，详见 图片 API |
/v1/audio/transcriptions | POST | 语音转文字（Whisper 兼容） |
/v1/audio/translations | POST | 语音翻译 |
/v1/audio/speech | POST | 文字转语音（TTS） |
/v1/moderations | POST | 内容审核 |
/v1/rerank | POST | 重排序（Rerank，部分模型支持） |
/v1/models | GET | 获取当前可用模型列表 |
/v1/models/{model} | GET | 获取指定模型详情 |
其它协议兼容
除 OpenAI 协议外，网关同时支持以 x-api-key 头调用 /v1/messages（Anthropic Claude 原生协议），以及以 x-goog-api-key / ?key= 调用 Gemini 原生风格接口（/v1beta/...）。如果你的代码是直接基于 Anthropic 或 Google 官方 SDK 编写的，同样可以只替换请求地址接入 SDKMAX，无需改成 OpenAI 协议。
尚未支持 / 有限制的接口
/v1/images/variations（图片变体）暂未支持。/v1/files、/v1/fine-tunes等文件与微调相关接口目前为占位/未完全实现，请勿依赖。- Batch（批处理）接口暂未提供，替代方案见 Batch API。
如果你的场景依赖以上接口，建议先在 FAQ 或联系平台方确认路线图，避免线上依赖未支持能力。
用官方 OpenAI SDK 直接接入
因为协议兼容，你不需要专门的 SDKMAX SDK 也能使用 —— 直接用各语言官方 OpenAI SDK，指定 base_url 即可（示例见 快速开始）。SDKMAX 额外提供的 Python / Node.js / Java / Go SDK 页面，主要是给出针对 SDKMAX 场景（多模型切换、错误处理约定等）的推荐用法与示例，底层依然是标准 OpenAI 客户端。
视频与其它非 OpenAI 原生能力
视频生成（/v1/video/generations、/v1/videos）是 SDKMAX 在 OpenAI 协议基础上扩展的能力（对齐 OpenAI 新推出的 Video/Sora 接口风格），详见 视频 API。