模型列表是接入前的第一站。它回答“这把密钥可以看到哪些型号”，不回答“每个型号支持所有接口吗”。不同令牌分组、模型限制和线路状态，可能让返回结果不同。

方法、地址与鉴权#

目录格式方法与归壹完整地址推荐请求头
OpenAI 兼容GET https://univto.com/v1/modelsAuthorization: Bearer 你的归壹API密钥
Gemini 格式GET https://univto.com/v1beta/modelsx-goog-api-key: 你的归壹API密钥；需该格式入口已开放

最小示例：读取 OpenAI 格式目录#

在自己的终端设置，示例只有占位值
export GUIYI_API_KEY='替换成你自己的归壹API密钥'
export GUIYI_MODEL='替换成该接口可用的完整模型ID'
读取目录，不提交模型生成请求
curl --fail-with-body https://univto.com/v1/models \
  -H "Authorization: Bearer ${GUIYI_API_KEY}"

返回里重点看什么#

结构示意，模型名仅为占位，不代表实际开放型号
{
  "object": "list",
  "data": [
    {"id": "YOUR_MODEL_ID", "object": "model", "owned_by": "provider"}
  ]
}
字段怎么使用
data[].id程序请求中真正填写的模型ID，完整复制，保留大小写、日期与横线
data[].object对象类型，模型条目通常为 model
data[].owned_by元数据中的归属标记，不作为模型真实性或授权证明
data[].created部分返回提供创建时间戳；缺失时不影响以id识别模型

需要 Gemini 格式目录时#

仅在该令牌可访问 Gemini 目录时使用
curl --fail-with-body https://univto.com/v1beta/models \
  -H "x-goog-api-key: ${GUIYI_API_KEY}"

Gemini 格式通常以 models 数组返回，name 可能形如 models/某个型号，同时提供 displayName、inputTokenLimit、outputTokenLimit、supportedGenerationMethods 等字段。调用路径中的模型ID不应再重复加一层 models/。缺少某项元数据时，不要自行补造能力。

列表为空或返回报错#

结果先检查
401密钥完整性、有效期、是否停用，以及是否把网站密码当作密钥
403令牌分组与访问权限
200但数组为空该密钥的分组或模型限制是否包含目标模型；不要猜型号反复生成
404或格式不符确认使用的目录协议入口已开放；不要仅靠切换请求头推定格式自动转换

文本聊天接口

使用 messages 数组发送对话。

Gemini 原生接口

使用 contents 与 parts 发送文本或媒体。

模型广场怎么选

先确认用途、价格、分组与接口。