模型列表与可见性：/v1/models 只能证明“看得到”

看这篇前，先准备好当前令牌和目标模型

模型列表排障一定要用“当前正在出问题的那条令牌”。换令牌、换分组或换工具后看到的列表都不能证明原问题已经解决。

等不及了，先按这张表判断

/v1/models 是模型可见性检查，不是完整可用性检查。先按返回结果分层，再决定下一步。

/v1/models 用来解决什么

查询模型列表

使用 OpenAI 兼容地址请求模型列表。这个请求最适合做认证和分组的第一步检查。

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

curl "https://www.6xin.cc/v1/models" \
  -H "Authorization: Bearer $COMEU_API_KEY"

如果返回 JSON 里有 data 数组，说明令牌、Base URL 和基础认证大体可用。下一步要看目标模型是否在列表里，并继续做真实生成。

返回结果怎么看

不同客户端展示字段可能略有差异，但排查时重点看模型 ID、对象类型和是否属于当前用途。

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4.1-mini",
      "object": "model"
    },
    {
      "id": "claude-sonnet-示例模型",
      "object": "model"
    }
  ]
}

模型列表接口返回码速查

可见性不等于可调用

模型列表只回答“当前令牌看到了什么”。能不能成功调用，还要看接口路径、模型能力、参数和分组策略。

模型分组如何影响列表

6星中转 的令牌可以按用途绑定不同分组。分组能减少误用风险，也能让不同工具只看到自己应该使用的模型。

分组概念可以继续看 模型分组。

从模型列表到真实烟测

拿到模型 ID 后，用最短请求证明这个模型真的能在目标接口里工作。

聊天模型烟测

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer $COMEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型列表复制的模型ID",
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

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模型ID",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

图像或视频模型烟测

图像和视频不要用聊天接口验收。图像模型和视频模型都先看 图像与视频 API 示例，再按对应能力跑最小任务。

自动化检查时不要只测模型列表

很多监控脚本喜欢只请求 /v1/models，这只能证明网关、认证和列表接口还活着。更可靠的可用性检查应该分层做。

把模型列表接进启动检查

如果你的业务服务依赖固定模型，建议在服务启动或发布前做一次低频检查：先确认当前令牌能看到必需模型，再用短请求证明生成链路可用。这样可以在正式流量进来前发现分组迁移、模型下线或环境变量读错。

Node.js 最小启动探针

import OpenAI from "openai";

const apiKey = process.env.COMEU_API_KEY;
const requiredModel = process.env.COMEU_REQUIRED_MODEL || "gpt-4.1-mini";

if (!apiKey) {
  throw new Error("Missing COMEU_API_KEY");
}

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

const models = await client.models.list();
const available = new Set(models.data.map((model) => model.id));

if (!available.has(requiredModel)) {
  throw new Error(`6星中转 token cannot see required model: ${requiredModel}`);
}

const response = await client.chat.completions.create({
  model: requiredModel,
  messages: [{ role: "user", content: "回复 OK" }],
  max_tokens: 16,
});

if (!response.choices?.[0]?.message?.content) {
  throw new Error("6星中转 model is visible, but generation returned no text");
}

客户端缓存和刷新怎么处理

图形客户端或 SDK 包装层可能会缓存模型列表。你在 6星中转 控制台换了分组或令牌后，客户端不一定立刻刷新。

模型不可见或不可用怎么排查

模型列表配置异常后，先回到最小可用检查

如果你已经换过多个模型、多个分组或多个客户端，先把变量收回到一条令牌、一个模型、一个接口。这样更容易判断问题到底在认证、分组、模型 ID 还是真实生成链路。

这些情况先停下来，不要继续更换多个模型

模型列表只能证明“看得到”，不能证明“能稳定生成”。遇到下面这些现象时，先按层排查，不要把多个模型、多个分组和多个客户端混在一起测。

上线前不要漏这几件事

模型接入验收清单

仍然不通时，提交这些定位信息

模型列表问题经常被误判成“平台坏了”。提交问题前，先把“列表可见性”和“真实生成”两类信息分开整理。