Models（列出可用模型） - 数字先锋API文档

# 查询可用模型（OpenAI 兼容格式）

## 接口地址

```http
GET https://api.cxsee.com/v1/models
```

## 请求头

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

---

## 1）查询全部模型

```bash
curl -X GET "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

返回结果中：

- `data[].id` = 模型名称（调用时填入 `model` 字段）

---

## 2）只看模型 ID（更直观）

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id'
```

---

## 3）模型太多时：按前缀筛选

### 只看 `gpt` 开头模型

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("^gpt"; "i"))'
```

### 只看 `claude` 开头模型

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("^claude"; "i"))'
```
### 只看 `gemini` 开头模型

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("^gemini"; "i"))'
```

### 同时看 `gpt` 或 `claude` 开头

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("^(gpt|claude)"; "i"))'
```

---

## 4）关键词筛选（例如 search / thinking / o3）

### 包含 `search`

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("search"; "i"))'
```

### 包含 `thinking`

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("thinking"; "i"))'
```

### 以 `o3` 开头

```bash
curl -s "https://api.cxsee.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[].id | select(test("^o3"; "i"))'
```

---

## 5）Windows 用户（无 jq）简易方案

可先拿完整结果，再在终端里搜索关键词：

```bash
curl -s "https://api.cxsee.com/v1/models" -H "Authorization: Bearer YOUR_API_KEY"
```

然后使用编辑器查找 `id`、`gpt`、`claude` 等关键词。

---

## 6）常见问题

- `401 Unauthorized`：请检查 API Key 是否正确。
- 看不到某些模型：可能未开通权限或模型已下线。
- 拿到模型名后，直接用于请求体：
  ```json
  { "model": "gpt-4o-mini", ... }
  ```

---

上一篇：所有对话模型均兼容 OpenAI 格式下一篇：OpenAI 图像生成（绘画）