> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型列表

> 获取可用模型列表和详细信息

## 接口简介

Models API用于获取老张API平台支持的AI模型列表和详细信息。通过此接口，你可以查看所有可用的模型、了解模型特性和定价信息。

## 接口信息

**接口地址**：`GET https://api2.laozhang.ai/v1/models`

**兼容性**：完全兼容OpenAI官方API格式

## 获取模型列表

### 请求示例

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api2.laozhang.ai/v1/models \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import OpenAI from 'openai';

  const openai = new OpenAI({
    apiKey: 'YOUR_API_KEY',
    baseURL: 'https://api2.laozhang.ai/v1'
  });

  async function getModels() {
    const models = await openai.models.list();
    console.log(models);
  }

  getModels();
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="YOUR_API_KEY",
      base_url="https://api2.laozhang.ai/v1"
  )

  models = client.models.list()
  print(models)
  ```

  ```go Go theme={null}
  package main

  import (
      "context"
      "fmt"
      "github.com/sashabaranov/go-openai"
  )

  func main() {
      config := openai.DefaultConfig("YOUR_API_KEY")
      config.BaseURL = "https://api2.laozhang.ai/v1"

      client := openai.NewClientWithConfig(config)

      models, err := client.ListModels(context.Background())
      if err != nil {
          fmt.Printf("Error: %v\n", err)
          return
      }

      for _, model := range models.Models {
          fmt.Printf("Model: %s\n", model.ID)
      }
  }
  ```
</CodeGroup>

### 响应格式

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1687882411,
      "owned_by": "openai",
      "permission": [
        {
          "id": "modelperm-xxx",
          "object": "model_permission",
          "created": 1687882411,
          "allow_create_engine": false,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o",
      "parent": null
    },
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1687882411,
      "owned_by": "openai",
      "permission": [...],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}
```

## 获取特定模型信息

### 请求示例

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api2.laozhang.ai/v1/models/gpt-4o \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const model = await openai.models.retrieve('gpt-4o');
  console.log(model);
  ```

  ```python Python theme={null}
  model = client.models.retrieve('gpt-4o')
  print(model)
  ```

  ```go Go theme={null}
  model, err := client.GetModel(context.Background(), "gpt-4o")
  if err != nil {
      fmt.Printf("Error: %v\n", err)
      return
  }
  fmt.Printf("Model: %+v\n", model)
  ```
</CodeGroup>

### 响应格式

```json theme={null}
{
  "id": "gpt-4o",
  "object": "model",
  "created": 1687882411,
  "owned_by": "openai",
  "permission": [
    {
      "id": "modelperm-xxx",
      "object": "model_permission",
      "created": 1687882411,
      "allow_create_engine": false,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": false,
      "allow_view": true,
      "allow_fine_tuning": false,
      "organization": "*",
      "group": null,
      "is_blocking": false
    }
  ],
  "root": "gpt-4o",
  "parent": null
}
```

## 响应字段说明

| 字段           | 类型      | 说明               |
| ------------ | ------- | ---------------- |
| `id`         | string  | 模型的唯一标识符         |
| `object`     | string  | 对象类型，固定为 "model" |
| `created`    | integer | 模型创建时间戳          |
| `owned_by`   | string  | 模型所有者            |
| `permission` | array   | 模型权限列表           |
| `root`       | string  | 根模型名称            |
| `parent`     | string  | 父模型名称（如果有）       |

## 主要模型分类

### OpenAI 系列

<AccordionGroup>
  <Accordion icon="bot" title="GPT-5.5 系列">
    OpenAI 当前旗舰模型，适合复杂推理、专业工作和代码生成。

    **可用模型：**

    * `gpt-5.5` - 最新旗舰模型
    * `gpt-5.5-pro` - 更高算力版本，适合难题和长流程任务

    **特点：**

    * 支持 1M 上下文
    * 适合复杂推理和编程 Agent
    * 优秀的多语言能力
  </Accordion>

  <Accordion icon="bot" title="GPT-5 / GPT-4.1 系列">
    稳定通用模型系列，覆盖主力生产和成本敏感场景。

    **可用模型：**

    * `gpt-5` - 通用高级任务
    * `gpt-5-mini` - 轻量高效版本
    * `gpt-5-nano` - 大批量低成本任务
    * `gpt-4.1` - 经典稳定模型
    * `gpt-4.1-mini` - 快速、经济的通用选择

    **特点：**

    * 兼容常见 OpenAI SDK
    * 覆盖从高质量到低成本的不同需求
    * 良好的代码理解能力
  </Accordion>

  <Accordion icon="bot" title="推理模型">
    专为复杂推理任务设计的模型

    **可用模型：**

    * `o3-pro` - 顶级推理任务
    * `o3` - 复杂推理、数学、编程
    * `o4-mini` - 轻量推理和编程成本控制选择

    **特点：**

    * 强大的数学推理能力
    * 适合复杂逻辑问题
    * 建议按任务复杂度选择不同档位
  </Accordion>
</AccordionGroup>

### Claude 系列

<AccordionGroup>
  <Accordion icon="bot" title="Claude 4.7 / 4.6 系列">
    Anthropic 当前主力模型，适合编程 Agent、复杂推理和长文本处理。

    **可用模型：**

    * `claude-opus-4-7` - 当前最强通用模型
    * `claude-opus-4-7-thinking` - 深度推理模式
    * `claude-sonnet-4-6` - 平衡速度、成本和智能
    * `claude-sonnet-4-6-thinking` - Sonnet 推理模式
    * `claude-haiku-4-5` - 快速轻量版本

    **特点：**

    * 优秀的代码生成能力
    * 强大的文本理解能力
    * 适合多步工具调用和长流程任务
  </Accordion>

  <Accordion icon="bot" title="Claude 4.5 / 旧版兼容">
    旧项目可继续使用的经典高性能版本，新项目建议优先选择 Opus 4.7 或 Sonnet 4.6。

    **可用模型：**

    * `claude-opus-4-5` - 经典高性能版本
    * `claude-sonnet-4-5` - 稳定编程版本
    * `claude-3-7-sonnet-latest` - 旧版兼容
    * `claude-3-5-sonnet-latest` - 旧版兼容

    **特点：**

    * 适合已有配置平滑迁移
    * 不建议作为新文档首选示例
  </Accordion>
</AccordionGroup>

### Google Gemini 系列

<AccordionGroup>
  <Accordion icon="globe" title="Gemini 3.1 / 3 系列">
    Google 最新 Gemini 系列，适合多模态、长上下文和工具调用。

    **可用模型：**

    * `gemini-3.1-pro-preview` - 最新 Pro 预览模型
    * `gemini-3.1-pro-preview-customtools` - 自定义工具和 bash 工作流
    * `gemini-3-flash-preview` - 快速多模态模型
    * `gemini-3.1-flash-lite-preview` - 轻量快速版本
    * `gemini-3-pro-image-preview` - 图像生成模型

    **特点：**

    * 长上下文和多模态输入
    * 多模态能力强
    * `gemini-3-pro-preview` 已停止服务，请迁移到 `gemini-3.1-pro-preview`
  </Accordion>

  <Accordion icon="globe" title="Gemini 2.5 系列">
    稳定生产可用的 Gemini 2.5 系列。

    **可用模型：**

    * `gemini-2.5-pro` - 稳定长上下文和多模态模型
    * `gemini-2.5-flash` - 快速响应版本
    * `gemini-2.5-flash-lite` - 轻量版本
    * `gemini-2.5-flash-image` - 图像生成版本

    **特点：**

    * 适合生产环境和成本优化
    * 与 Gemini 3 系列形成稳定/尝鲜搭配
  </Accordion>
</AccordionGroup>

### 国产大模型

<AccordionGroup>
  <Accordion icon="languages" title="阿里通义系列">
    阿里巴巴开发的大语言模型

    **可用模型：**

    * `qwen-turbo` - 快速版本
    * `qwen-plus` - 高性能版本
    * `qwen-max` - 最强版本

    **特点：**

    * 中文能力出众
    * 多领域知识丰富
    * 成本较低
  </Accordion>

  <Accordion icon="code" title="DeepSeek 系列">
    专注于代码和推理的模型

    **可用模型：**

    * `deepseek-chat` - 对话模型
    * `deepseek-coder` - 代码专用
    * `deepseek-v2.5` - 最新版本

    **特点：**

    * 代码能力突出
    * 推理能力强
    * 开源友好
  </Accordion>

  <Accordion icon="brain" title="智谱GLM系列">
    清华大学研发的大模型

    **可用模型：**

    * `glm-4` - 第四代模型
    * `glm-4v` - 多模态版本
    * `glm-3-turbo` - 快速版本

    **特点：**

    * 学术能力强
    * 中英文双语优秀
    * 适合研究应用
  </Accordion>
</AccordionGroup>

## 图像生成模型

### 文本到图像

| 模型ID                  | 厂商           | 特点      | 价格       |
| --------------------- | ------------ | ------- | -------- |
| `dall-e-3`            | OpenAI       | 高质量图像生成 | \$0.04/张 |
| `dall-e-2`            | OpenAI       | 经典图像生成  | \$0.02/张 |
| `gpt-4o-image`        | 老张API优化      | 图像生成能力  | \$0.01/张 |
| `flux-pro`            | Flux         | 专业级质量   | \$0.05/张 |
| `flux-dev`            | Flux         | 开发版本    | \$0.03/张 |
| `midjourney-v6`       | Midjourney   | 艺术性强    | \$0.08/张 |
| `stable-diffusion-xl` | Stability AI | 开源高质量   | \$0.02/张 |

### 图像理解

| 模型ID                     | 厂商        | 特点          | 价格               |
| ------------------------ | --------- | ----------- | ---------------- |
| `gpt-4o`                 | OpenAI    | 图像理解能力强     | \$5/1M tokens    |
| `gpt-4o-mini`            | OpenAI    | 轻量图像理解      | \$0.15/1M tokens |
| `gemini-3.1-pro-preview` | Google    | 多模态理解、长上下文  | 以控制台为准           |
| `claude-opus-4-7`        | Anthropic | 文档图像理解、复杂分析 | 以控制台为准           |

## 语音模型

### 文本转语音 (TTS)

| 模型ID       | 厂商     | 特点     | 价格        |
| ---------- | ------ | ------ | --------- |
| `tts-1`    | OpenAI | 标准语音合成 | \$15/1M字符 |
| `tts-1-hd` | OpenAI | 高清语音合成 | \$30/1M字符 |

### 语音转文本 (STT)

| 模型ID        | 厂商     | 特点      | 价格         |
| ----------- | ------ | ------- | ---------- |
| `whisper-1` | OpenAI | 多语言语音识别 | \$0.006/分钟 |

## 使用建议

### 根据场景选择模型

<CardGroup cols={2}>
  <Card title="日常对话" icon="message-circle" href="/api-reference/chat-completions">
    推荐：GPT-5.5、Claude Sonnet 4.6、Gemini 3 Flash Preview
    特点：响应快、成本低、质量好
  </Card>

  <Card title="代码生成" icon="code" href="/api-reference/openai">
    推荐：GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6
    特点：代码理解能力强、生成质量高
  </Card>

  <Card title="复杂推理" icon="brain" href="/api-capabilities/model-info">
    推荐：GPT-5.5、o3-pro、Claude Opus 4.7 Thinking
    特点：逻辑推理能力强、适合数学问题
  </Card>

  <Card title="中文处理" icon="languages" href="/api-capabilities/model-info">
    推荐：通义千问、GLM-4、文心一言
    特点：中文理解和生成能力优秀
  </Card>
</CardGroup>

### 成本控制选择

<AccordionGroup>
  <Accordion icon="dollar-sign" title="预算优先">
    **推荐模型：**

    * `gpt-4.1-mini`
    * `claude-haiku-4-5`
    * `gemini-3.1-flash-lite-preview`
    * `deepseek-chat`

    **适用场景：**

    * 大量文本处理
    * 批量数据分析
    * 开发测试阶段
  </Accordion>

  <Accordion icon="zap" title="性能优先">
    **推荐模型：**

    * `gpt-5.5`
    * `claude-opus-4-7`
    * `claude-opus-4-7-thinking`
    * `gemini-3.1-pro-preview`

    **适用场景：**

    * 关键业务应用
    * 复杂推理任务
    * 高质量内容生成
  </Accordion>

  <Accordion icon="scale" title="平衡选择">
    **推荐模型：**

    * `claude-sonnet-4-6`
    * `gpt-5`
    * `gemini-2.5-pro`
    * `o4-mini`

    **适用场景：**

    * 日常业务应用
    * 中等复杂度任务
    * 长期稳定使用
  </Accordion>
</AccordionGroup>

## 实时获取模型信息

你可以通过API实时获取最新的模型列表和价格信息：

```python theme={null}
import requests

# 获取模型列表
response = requests.get(
    "https://api2.laozhang.ai/v1/models",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

models = response.json()
for model in models['data']:
    print(f"模型: {model['id']}, 所有者: {model['owned_by']}")
```

## 错误处理

| 错误码 | 说明        | 解决方案           |
| --- | --------- | -------------- |
| 401 | API Key无效 | 检查API Key是否正确  |
| 403 | 权限不足      | 确认API Key有访问权限 |
| 404 | 模型不存在     | 检查模型ID是否正确     |
| 429 | 请求过于频繁    | 降低请求频率         |
| 500 | 服务器错误     | 稍后重试或联系支持      |

***

<CardGroup cols={2}>
  <Card title="查看完整模型列表" icon="list" href="/api-capabilities/model-info">
    查看所有200+AI模型的详细信息和价格
  </Card>

  <Card title="开始使用Chat API" icon="message-circle" href="/api-reference/chat-completions">
    了解如何使用Chat Completions API调用模型
  </Card>
</CardGroup>