聊天补全与 Messages：两套口径别混用

看这篇前，先确认你要接哪种入口

聊天接口最常见的问题不是代码不会写，而是把 OpenAI 兼容、Claude 原生和模型能力混在一起。开始前先把下面 4 件事定下来。

该选哪套接口

OpenAI 兼容聊天补全

这是大多数 SDK、聊天客户端和后端服务最容易接入的方式。请求体使用 messages 数组，响应里读取 choices[0].message.content。

export COMEU_API_KEY="sk-你的6星中转令牌"

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer $COMEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手。"},
      {"role": "user", "content": "用一句话介绍 6星中转。"}
    ],
    "temperature": 0.7
  }'

Python SDK 示例

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMEU_API_KEY"],
    base_url="https://www.6xin.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手。"},
        {"role": "user", "content": "用一句话介绍 6星中转。"},
    ],
)

print(response.choices[0].message.content)

Node.js SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMEU_API_KEY,
  baseURL: "https://www.6xin.cc/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4.1-mini",
  messages: [
    { role: "system", content: "你是一个简洁的助手。" },
    { role: "user", content: "用一句话介绍 6星中转。" },
  ],
});

console.log(response.choices[0].message.content);

Anthropic Messages 口径

Claude 原生工具通常按 Messages 协议组织请求。配置 Claude Code 或 Claude SDK 的 Base URL 时填 6星中转 根地址；如果你直接用 curl 请求接口，则写完整路径 https://www.6xin.cc/v1/messages。

export COMEU_API_KEY="sk-你的6星中转令牌"

curl "https://www.6xin.cc/v1/messages" \
  -H "x-api-key: $COMEU_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-示例模型",
    "max_tokens": 512,
    "system": "你是一个简洁的助手。",
    "messages": [
      {"role": "user", "content": "用一句话介绍 6星中转。"}
    ]
  }'

流式输出怎么测

流式输出适合命令行工具和长回复场景。第一次上线前要单独测试流式请求，因为“非流式成功”不代表“流式事件一定能被你的客户端正确解析”。

OpenAI 兼容流式

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer $COMEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "stream": true,
    "messages": [
      {"role": "user", "content": "分三点说明 API 接入前要检查什么。"}
    ]
  }'

Messages 流式

curl "https://www.6xin.cc/v1/messages" \
  -H "x-api-key: $COMEU_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-示例模型",
    "max_tokens": 512,
    "stream": true,
    "messages": [
      {"role": "user", "content": "分三点说明 API 接入前要检查什么。"}
    ]
  }'

放进工具或客户端时怎么填

如果你正在接工具，可以先看 工具接入总览，再进入对应工具页。

真实请求验收顺序

不要只看 SDK 初始化成功，也不要只看模型列表。推荐按下面顺序做，能快速定位问题属于认证、分组、模型还是协议。

常见错误对照

这些情况先停下来，不要继续加复杂参数

聊天接口排障要从最小请求开始。只要基础请求还没有稳定返回，就不要先加流式、长上下文、工具调用或业务系统变量。

改错后怎么退回最小可用请求

聊天接口排障最怕连续改很多项。遇到异常时，先回到一条能独立复现的最小请求，再把业务参数一项一项加回来。

聊天接口验收清单

聊天请求仍然失败时，提交这些复现信息

提交问题前，先把请求缩到最小：一个模型、一条用户消息、一个接口口径。这样才能判断是协议、令牌、模型、流式解析还是业务代码问题。

整理后可直接套用 FAQ 工单模板；如果是模型可见但生成失败，先回 模型真实烟测 对照。