Moderations 和旧版 Completions #

这两个接口主要用于兼容已有应用。新项目如果只是做聊天，优先使用 /v1/chat/completions。

内容审核 Moderations #

Moderations 用于判断输入文本是否命中安全类别。实际类别、阈值和返回字段取决于所选模型或渠道。

如果不传 model，系统可能使用默认审核模型。生产环境建议显式填写控制台中的审核模型 ID。

export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"

curl https://api.corerouter.tech/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COREROUTER_API_KEY" \
  -d '{
    "model": "moderation-model-id",
    "input": "这里放需要审核的用户输入。"
  }'

常见用途：

• 用户内容发布前审核。
• 对话输入预检查。
• 对模型输出做二次审核。
• 给不同业务设置不同拦截策略。

旧版 Completions #

/v1/completions 是旧版文本补全接口，请求字段通常是 prompt，不是 Chat Completions 的 messages。

curl https://api.corerouter.tech/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COREROUTER_API_KEY" \
  -d '{
    "model": "completion-model-id",
    "prompt": "把下面这句话补完整：CoreRouter 可以帮助开发者",
    "max_tokens": 128
  }'

Chat Completions 和 Completions 的区别 #

不要把 messages 传给 /v1/completions，也不要把 prompt 当成 /v1/chat/completions 的主要输入。

常见问题 #

• field input is required：Moderations 缺少 input。
• field prompt is required：Completions 缺少 prompt。
• 审核模型不可用：检查控制台是否提供审核模型，或者显式换用可用模型。
• 旧 SDK 报错：确认它调用的是 /v1/completions，Base URL 应填写 https://api.corerouter.tech/v1。