极简教程：使用 Curl 获取 OpenAI 全部可用模型列表

10次阅读

在日常开发、调试 AI 接口的过程中，我们经常需要查看当前 OpenAI API Key 支持的所有模型，区分 GPT 对话模型、嵌入模型、语音模型等。本文分享全网最简 Curl 命令，无需代码、无需 SDK，一行命令快速获取、筛选 OpenAI 可用模型列表，兼容 macOS、Linux、Windows 全平台。

一、接口原理

OpenAI 官方提供公开模型查询接口，通过 GET 请求即可获取当前密钥权限下的所有可用模型元数据，接口地址如下：

https://api.openai.com/v1/models

核心特点：接口返回结果与 API Key 权限绑定，不同账号、不同付费等级能查询到的模型列表不同，未付费账号无法调用 GPT-4 系列模型。

二、全平台 Curl 命令

1、基础查询命令（原生输出）

适用于 Linux / macOS / Git Bash 终端，直接请求获取完整模型数据：

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer 你的OpenAI-Key"

⚠️ 注意：将 你的OpenAI-Key 替换为自己的 sk 开头密钥。

2、美化格式化输出（推荐）

原生返回的 JSON 数据紧凑杂乱，搭配 jq 工具可自动格式化、高亮排版，可读性极强：

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer 你的OpenAI-Key" | jq .

若无 jq 工具，可通过 brew install jq（macOS）、apt install jq（Linux）快速安装。

3、只提取模型 ID（核心常用）

开发中仅需要模型名称（ID），可通过筛选命令直接输出纯净模型列表，方便复制使用：

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer 你的OpenAI-Key" | jq -r '.data[].id'

4、Windows PowerShell 专用命令

Windows 终端需调整语法，适配原生 Curl 请求：

curl "https://api.openai.com/v1/models" `
  -H "Authorization: Bearer 你的OpenAI-Key"

三、接口返回数据示例

成功请求后，会返回标准 JSON 格式数据，包含模型 ID、创建时间、归属主体等核心信息：

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "system"
    },
    {
      "id": "gpt-3.5-turbo",
      "object": "model",
      "created": 1677610602,
      "owned_by": "openai"
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1677610602,
      "owned_by": "openai"
    }
  ]
}

四、进阶：筛选纯对话模型

OpenAI 接口会返回对话、嵌入、语音、翻译等所有模型，我们可通过过滤命令只保留 GPT 对话模型，精准适配对话场景开发：

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer 你的OpenAI-Key" | jq -r '.data[].id' | grep gpt

五、关键注意事项（避坑重点）

权限差异化：模型列表由 API Key 权限决定，免费账号仅能使用 gpt-3.5-turbo 等基础模型，付费账号可解锁 GPT-4、GPT-4o 等高阶模型。
网络环境：国内无法直连 OpenAI 官方接口，需配置合规代理网络，或替换为兼容 OpenAI 协议的中转域名。
模型分类区分：查询结果包含多类型模型，gpt 系列为对话模型，text-embedding 为向量嵌入模型，whisper 为语音转文字模型，需根据业务场景选用。
密钥安全：请勿在公网、代码仓库、公开终端日志中暴露 API Key，避免密钥泄露产生不必要的扣费风险。