文本对话 API

文本模型使用 Bearer 认证和 OpenAI Chat Completions 兼容结构。基础地址是 https://api.rtoc.cc。

请求结构

POST /v1/chat/completions 接收 model、messages 和可选生成参数。消息按顺序传入，可以包含 system、user 与 assistant 角色。

{
  "model": "gpt-5.6-luna",
  "stream": false,
  "messages": [
    { "role": "system", "content": "回答保持准确、简洁。" },
    { "role": "user", "content": "什么是幂等请求？" }
  ]
}

非流式响应通常从 choices[0].message.content 读取。生产代码还应记录请求 ID、HTTP 状态和受控长度的错误正文，但不得记录 Authorization 请求头。

流式响应

需要逐段输出时，将 stream 设为 true，并按 Server-Sent Events 处理响应。下面仅展示协议差异；完整可运行示例默认使用更容易验证的非流式模式。

curl --no-buffer --max-time 120 https://api.rtoc.cc/v1/chat/completions \
  -H "Authorization: Bearer ${RTOC_API_KEY}" \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d "{\"model\":\"${RTOC_CHAT_MODEL}\",\"stream\":true,\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

客户端应逐个解析 data: 事件，并在收到 [DONE] 后结束；不要把多个事件当作一个 JSON 文档解析。

与 OpenAI 兼容客户端配合

如果客户端允许自定义基础地址，可将 base_url 设置为 https://api.rtoc.cc/v1，API Key 仍从环境变量读取。不同模型支持的端点可能不同，请在 RTOC 模型广场 核对 supported_endpoint_types，并以 生产文档 为准。