API 参考

OpenAI 与 Anthropic 兼容的模型 API。字段以生产实现为准。Base URL：https://api.aiops.red

认证

所有端点需要 Bearer Token，Key 在控制台「API Keys」页创建：

Authorization: Bearer sk-cf-...

POST /v1/chat/completions

OpenAI Chat Completions 兼容，支持流式与工具调用。

modelstring模型别名，如 chrono-1 / chrono-ops-1 / chrono-code-1

messagesarray对话消息（system/user/assistant/tool）

streambool流式返回；true 时按 SSE 逐块推送

toolsarray工具定义（function calling），原样透传

tool_choicestring/objauto / required / none 或指定工具

max_tokensint最大输出 token

thinkingobject深度思考控制，如 {"type":"disabled"} 关闭

curl https://api.aiops.red/v1/chat/completions \
  -H "Authorization: Bearer $CHRONO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"chrono-1","messages":[{"role":"user","content":"你好"}]}'

响应在标准 OpenAI 结构上附带 chrono 回执块。流式首事件为 chrono.receipt，末尾 data: [DONE]。

POST /v1/messages

Anthropic Messages 协议兼容，让 Claude Code / Anthropic SDK 直接指过来。字段：model、max_tokens（必填）、messages、system、stream、tools（input_schema）、tool_choice。

curl https://api.aiops.red/v1/messages \
  -H "Authorization: Bearer $CHRONO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"chrono-code-1-fast","max_tokens":512,
       "messages":[{"role":"user","content":"重构这段代码"}]}'

响应为 Anthropic 形状。流式为 message_start → content_block_* → message_delta → message_stop。图片等多模态内容块暂不支持，返回 400（不静默丢弃）。

POST /v1/feedback/events

对已完成的推理回传反馈，驱动模型增强。

feedback_event_iduuid客户端生成的幂等键

inference_idstring目标推理的回执标识（inf_...）

verdictenumaccepted / rejected / corrected

supersedes_feedback_idstring改主意时引用上一条反馈，走修正链

响应含服务端签发的 feedback_id 与 status（recorded / already_recorded）。反馈只能落在本租户自己的推理回执上。

推理回执

每次调用可被追问、可对账：响应头 X-Chrono-Inference-Id 给出回执标识，响应体 chrono 块含 inference_id、resolved_model_snapshot、schema_version。输入/上下文/输出/交付内容的 SHA-256 哈希可按 RFC 8785（JCS）独立复算。回执先落库、后应答。

错误格式

{
  "error": {
    "type": "invalid_request",
    "code": "context_length_exceeded",
    "message": "..."
  },
  "request_id": "..."
}

request_id 用于排查，提工单时附上。常见码：invalid_request、context_length_exceeded、invalid_model、insufficient_balance、content_policy_violation、rate_limited。

免费注册领体验包 Claude Code 接入教程