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

# 获取模型列表

> 返回当前 token 在 `POST /v1/llm/generations`（`llm-custom` 协议）下**实际可用**的模型，及每个模型支持能力的并集。客户端可凭此动态构建模型选择 UI，无需依赖静态枚举。

- 认证：与提交端点共用 Bearer Token，按 token 所属分组过滤可见模型
- `id`：可直接填入 `LLMCustomRequest.model` 字段的模型名
- `capabilities`：该模型支持能力的并集，顺序固定 `text` → `vision` → `video` → `audio` → `file`
- 当前 token 分组下无任何可达模型时，返回 `200 { "object": "list", "data": [] }`（不是 404）




## OpenAPI

````yaml openapi/zh/configs-llm-generations-models.json GET /v1/configs/llm_generations_models
openapi: 3.1.0
info:
  title: LLM Custom 可用模型清单
  version: '1.0'
servers:
  - url: https://api.aihubmax.com
security:
  - BearerAuth: []
paths:
  /v1/configs/llm_generations_models:
    get:
      tags:
        - Config Query
      summary: 查询当前 token 可见的 LLM Custom 模型清单
      description: >
        返回当前 token 在 `POST /v1/llm/generations`（`llm-custom`
        协议）下**实际可用**的模型，及每个模型支持能力的并集。客户端可凭此动态构建模型选择 UI，无需依赖静态枚举。


        - 认证：与提交端点共用 Bearer Token，按 token 所属分组过滤可见模型

        - `id`：可直接填入 `LLMCustomRequest.model` 字段的模型名

        - `capabilities`：该模型支持能力的并集，顺序固定 `text` → `vision` → `video` → `audio` →
        `file`

        - 当前 token 分组下无任何可达模型时，返回 `200 { "object": "list", "data": [] }`（不是 404）
      operationId: configs-llm-generations-models
      responses:
        '200':
          description: 查询成功，返回可用模型数组
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelListResponse'
              examples:
                typical:
                  summary: 典型返回
                  value:
                    object: list
                    data:
                      - id: claude-opus-4-7
                        object: model
                        capabilities:
                          - text
                          - vision
                          - file
                      - id: gemini-3.5-flash
                        object: model
                        capabilities:
                          - text
                          - vision
                          - video
                          - audio
                          - file
                      - id: gpt-5.5
                        object: model
                        capabilities:
                          - text
                          - vision
                empty:
                  summary: 当前 token 分组下无可达模型
                  value:
                    object: list
                    data: []
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ModelListResponse:
      type: object
      description: '`GET /v1/configs/llm_generations_models` 响应'
      required:
        - object
        - data
      properties:
        object:
          type: string
          enum:
            - list
        data:
          type: array
          items:
            type: object
            required:
              - id
              - object
              - capabilities
            properties:
              id:
                type: string
                description: 客户端可直接传入 `LLMCustomRequest.model` 的模型名
              object:
                type: string
                enum:
                  - model
              capabilities:
                type: array
                items:
                  type: string
                  enum:
                    - text
                    - vision
                    - video
                    - audio
                    - file
                description: >-
                  该模型在所有可见渠道上支持能力的并集，顺序固定 `text` → `vision` → `video` → `audio`
                  → `file`
    ErrorResponse401:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              example: API密钥无效
            type:
              type: string
              example: authentication_error
  responses:
    Unauthorized:
      description: 未授权
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse401'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        ## 所有接口均需要使用Bearer Token进行认证 ##

        使用时在请求头中添加：

        `Authorization: Bearer YOUR_API_KEY`

````