---
title: "修改模型显示信息"
method: PATCH
path: "/models/{id}"
tags: ["模型管理"]
---

# 修改模型显示信息

`PATCH /models/{id}`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/models/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

只修改显示名称和描述；接入配置与凭据保持不变。

## Path parameters

- `id` string, required

## Request body

- InternalHandlerPatchModelRequest
  - `description` string: 新的描述
  - `display_name` string: 新的显示名称，空字符串表示改回使用模型名

## Response `200`

更新后的模型

- object
  - `data` GithubComTencentWeKnoraInternalHandlerDtoModelResponse
    - `capabilities` GithubComTencentWeKnoraInternalModelsRuntimeCapabilities
      - `api` 'openai-completions' | 'openai-responses' | 'anthropic-messages' | 'google-generative-ai' | 'ollama'
      - `cataloged` boolean
      - `context_window` integer
      - `input` string[]
      - `max_output_tokens` integer
      - `max_tokens_field` string
      - `provider` string
      - `reasoning` boolean
      - `thinking_format` string
      - `thinking_levels` GithubComTencentWeKnoraInternalModelsApiReasoningEffort[]
    - `created_at` string
    - `credentials` object: Per-field "configured?" map. Omitted for builtin models unless the caller is a system administrator. See MCPServiceResponse.Credentials.
    - `description` string
    - `display_name` string
    - `id` string
    - `is_builtin` boolean
    - `is_default` boolean
    - `name` string
    - `parameters` GithubComTencentWeKnoraInternalHandlerDtoModelParametersDTO
      - `app_id` string
      - `base_url` string: BaseURL is empty for callers who may not view integration detail, and for builtin models; see NewModelResponse.
      - `context_window` integer
      - `custom_headers` object
      - `embedding_parameters` GithubComTencentWeKnoraInternalTypesEmbeddingParameters
        - `dimension` integer
        - `supports_dimension_override` boolean
        - `truncate_prompt_tokens` integer
      - `extra_config` object
      - `interface_type` string
      - `max_concurrency` integer
      - `max_output_tokens` integer
      - `parameter_size` string
      - `provider` string
      - `spec` GithubComTencentWeKnoraInternalTypesModelSpecOverride
        - `api` string
        - `compat` object: Compat is a plain object so it round-trips through both JSON (API, database column) and YAML (builtin_models.yaml).
        - `context_window` integer
        - `input` string[]
        - `max_output_tokens` integer
        - `reasoning` boolean
        - `thinking_levels` object
      - `supports_vision` boolean
    - `source` 'local' | 'remote' | 'aliyun' | 'zhipu' | 'volcengine' | 'deepseek' | 'hunyuan' | 'minimax' | 'openai' | 'gemini' | 'mimo' | 'siliconflow' | 'jina' | 'openrouter' | 'litellm' | 'requesty' | 'nvidia' | 'novita' | 'azure_openai'
    - `status` 'active' | 'downloading' | 'download_failed'
    - `tenant_id` integer
    - `type` 'Embedding' | 'Rerank' | 'KnowledgeQA' | 'VLLM' | 'ASR'
    - `updated_at` string
  - `success` boolean

## Other responses

- `400`: 请求参数错误
- `403`: 内置模型只能由系统管理员修改
- `404`: 模型不存在

## Changes

- **2026-10-16** `3277b0857c99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/models/:id/patch.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/weknora-api/revisions/685d1f9fce30?raw)