---
title: "复制模型"
method: POST
path: "/models/{id}/copy"
tags: ["模型管理"]
---

# 复制模型

`POST /models/{id}/copy`

## 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}/copy`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

复制模型配置。name 与源模型一致，凭证从已存记录复制，不接受客户端重传。

## Path parameters

- `id` string, required

## Request body

- InternalHandlerCopyModelRequest
  - `display_name` string, required: Display name of the new copy; the upstream model identifier stays unchanged.

## Response `201`

复制的模型

- 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`: 请求参数错误
- `404`: 模型不存在

## Changes

- **2026-10-14** `a1c41ab134cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/models/:id/copy/post.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)