如何使用 GET /v1/models 获取当前可用模型

直接答案

OpenAI 官方 List models 参考说明了 GET /models 和模型对象列表；本页把该请求模式应用于 Primordial AI 兼容端点，不代表 OpenAI 对第三方服务的背书。

使用 cURL 调用实时接口

export PRIMORDIAL_API_KEY="YOUR_PRIMORDIAL_API_KEY"

curl --fail-with-body \
  https://www.primoraihub.com/v1/models \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY"

2026-08-24 的未鉴权实时检查返回 HTTP 401。如果该命令被拒绝，请检查密钥是否存在、是否包含额外空格、是否属于目标账户，并确保密钥只由服务端加载。

使用 Python 与 JavaScript 读取模型 ID

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PRIMORDIAL_API_KEY"],
    base_url="https://www.primoraihub.com/v1",
)

models = client.models.list()
model_ids = [model.id for model in models.data]
if not model_ids:
    raise RuntimeError("没有返回模型 ID")
print("\n".join(model_ids))

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PRIMORDIAL_API_KEY,
  baseURL: "https://www.primoraihub.com/v1",
});

const models = await client.models.list();
const modelIds = models.data.map((model) => model.id);
if (modelIds.length === 0) throw new Error("没有返回模型 ID");
console.log(modelIds.join("\n"));

构造参数详见 OpenAI SDK 自定义 Base URL 指南。

不要猜测模型名称

1. 使用生产请求实际所属的账户和环境获取带鉴权的实时列表。
2. 选定候选 ID 前，先在当前 Primordial AI 文档中确认所需接口和功能。
3. 先执行一个最小非流式请求，再分别测试流式、工具、图片或应用依赖的其他能力。
4. 固定已验证 ID 以保持可重复性，同时保留健康检查和明确的替换流程。

不要自动选择返回列表中的第一项或按字母排序后的第一项；模型列表用于发现 ID，不是能力或价格排名。

排查鉴权和模型不存在错误

HTTP 401

Bearer Token 缺失或无效。检查环境变量、请求头拼写、额外空格和创建该密钥的 Primordial AI 账户。参考API Key 快速入门创建、安全保存并测试替代 Key，不要输出密钥值。

模型列表正常，但生成请求拒绝该模型

确认 ID 与当前返回结果完全一致，并确认目标接口支持它。模型出现在发现列表中，不代表所有请求格式和可选参数都被支持。

之前可用的 ID 突然失效

刷新实时列表，与固定 ID 对比，并在改变生产流量前告警；不要静默切换到任意第一项。

列表为空或结构异常

记录 HTTP 状态与 Request ID，但不要记录 API Key。把空列表或异常响应视为健康检查失败，不要继续使用猜测的模型名。

更安全的生产刷新方案

• 在部署或启动时获取列表，并按业务对目录变化的容忍度定期刷新。
• 只缓存应用需要的模型元数据；不要把 API Key 或带密钥的原始请求暴露到浏览器。
• 用刷新结果验证当前配置；模型消失时明确告警并停止未经批准的自动替换。
• 把模型选择与自动故障切换分开；替代模型可能在接口、延迟、价格、上下文或工具行为上不同。
• 每次有意更换模型后，对生产使用的精确请求结构执行回归测试。

常见问题