与 OpenAI 官方 API 的差异对照。集成前请对照本表与各 API 参考页。
兼容良好的部分
| 领域 | 说明 |
|---|---|
| Chat Completions | messages、stream、tools / tool_calls 主流程 |
| Embeddings | model + input |
| Files | 上传、列表、删除、下载 |
| Audio speech | model、input、voice、格式 |
| 错误体 | { error: { message, type, param, code } } 结构 |
目录与模型 ID
| 项 | 连连智枢 | OpenAI 官方 |
|---|---|---|
| 列表 API | GET /models，OpenRouter 式 data[] | OpenAI 自有目录 |
model 值 | 目录 id（如 vendor/model） | gpt-4o 等 |
| 列表是否需 Key | 不需要 | 通常需要 |
定价字段为目录展示；详细计费见控制台。
网关扩展（官方无）
| 字段 | 说明 |
|---|---|
pdf_preprocess | PDF 预处理 |
extra_body | 并入上游 JSON |
stream_options.include_usage | 流式强制带用量 |
用户 content parts
| 支持 | 不支持（返回 400） |
|---|---|
text、image_url、input_audio、input_file | 旧版 file、video_url 等 |
input_file 须三选一：file_id / file_url / file_data+filename。
SDK
向量等能力请直接调 HTTP；SDK 封装范围见 SDK 限制。