“兼容 OpenAI”不是“OpenAI 的每一种接口都已开放”。模型、渠道、令牌权限和接口动作需要分别确认。教程中给出某个请求结构，也不代表已经对归壹当前线路完成实测。

这几类接口分别做什么？#

类别常见路径参考通俗解释与范围
旧文本补全 CompletionsPOST /v1/completions根据一段 prompt 续写文字；与聊天 messages 和 Responses input 不同
内容审查 ModerationsPOST /v1/moderations返回风险类别与标记；不是聊天问答，也不是自动提供完整风控
文件管理 Files/v1/files 与具体文件操作保存与管理文件资源；文件 ID 是否能被其他任务使用仍需对应接口支持
微调 Fine-tuning旧式 /v1/fine-tunes；部分现代实现使用 /v1/fine_tuning/jobs用数据定制模型的任务；路由和能力依实现版本区分，不能只换 URL

旧 Completions 与聊天接口不能混用#

旧 Completions 的核心输入是 prompt，常见输出正文位于 choices[].text。Chat Completions 使用 messages，常见正文位于 choices[].message.content；Responses 又是另一套结构。新项目优先按工具或 SDK 实际支持的协议选择，只有维护旧应用且平台确认支持时，才使用旧补全接口。

旧 Completions 最小请求体参考；不是归壹当前可用性证明
{
  "model": "REPLACE_WITH_ENABLED_COMPLETION_MODEL",
  "prompt": "请补全这句话：学习新工具时，第一步是",
  "max_tokens": 32,
  "stream": false
}

字段 max_tokens 的上限、stop、suffix、echo 或流式模式是否支持，都取决于模型与兼容层。聊天可用不能证明旧补全可用；旧补全成功也不能证明 Claude Code 的 Messages 或 Codex 的 Responses 工具调用可用。

Moderations 是辅助审查，不是放行凭证#

内容审查通常接收 input，返回 results 中的 flagged、categories、category_scores 等内容。具体模型、类别和支持的输入形式需单独确认；不能把任何同品牌聊天模型填进审查接口。

文本审查请求体参考；先确认审查模型与路由
{
  "model": "REPLACE_WITH_ENABLED_MODERATION_MODEL",
  "input": "这里放需要检查的测试文本。"
}

flagged 是模型的判断结果，category_scores 不是人工审核结论。一次未被标记不代表所有法律或业务要求均已满足；如果业务依赖审查，应事先定义超时、错误和人工复核时如何处理，不能在调用失败时自动视为通过。

聊天时能看文件，不等于 Files API 已开放#

把图片网址、文档内容或文件数据随聊天消息发送，与独立 /v1/files 文件管理是不同功能。即使某个模型能读 PDF，也不能由此推断可以列出、上传、下载或删除服务器上的文件资源。

你需要的能力接入前要确认
上传文件上传路由、鉴权、multipart 字段、大小与格式限制、用途 purpose
在模型任务中引用文件返回文件 ID 的作用域、哪个模型／接口能够引用、处理完成状态
查看或下载文件属于哪个用户或令牌，内容读取权限及返回方式
删除与过期删除含义、保存期限、关联任务影响及是否需要另外清理

微调与提示词、知识库是三件事#

提示词用于指导本次回答，知识库通常在请求时检索资料，微调则需要创建并管理训练任务。能设置 system 提示词、上传资料或调用现成模型，都不等于支持训练自己的模型。

  1. 1

    先确认产品范围

    确认支持的基础模型、训练数据格式、任务路由、权限与地区等限制。旧 /fine-tunes 路由不代表当前服务一定使用同一协议。

  2. 2

    再确认任务全流程

    需要覆盖创建、状态查询、事件、取消、结果模型使用以及相关文件管理，不能只验证一个提交接口。

  3. 3

    确认成本后再上传

    训练、存储与推理可能分别计费；先确认预算、保留期限和数据使用规则，示例中不要放真实客户材料。

接入前，确认自己的服务范围#

接口规范中列出路径，并不代表归壹已开放对应功能。文件管理、微调及其他扩展能力，应以归壹明确开放的功能、当前模型线路和实际测试结果为准；本页不把这些功能列为已通过验收的客户接口。

若接口返回 501，通常表示相关操作尚未实现；404 也可能来自路径错误或未开放入口。不要仅根据另一家平台的文档或一个状态码，判断归壹是否支持整类能力。