帮你快速理解、总结文档立即下载

创建推理模型

最近更新时间:2026-08-12 01:53:50
我的收藏

1. 接口描述

接口请求域名: dlc.tencentcloudapi.com 。

创建推理模型(模型上传)

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateInferenceModel。
Version String 公共参数,本接口取值:2021-01-25。
Region String 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-beijing, ap-chongqing, ap-guangzhou, ap-shanghai, ap-singapore 。
Name String

模型名称(最长 256)


示例值:capi_test_123
ModelType String

模型类型(如 LLM、Embedding、Reranker、ASR、TTS 等)


示例值:ML
InitialVersion String

初始版本号(必填,如 v1、v1.5)


示例值:v1
Provider String

模型提供方


示例值:personal
Description String

模型描述


示例值:description
ParameterSize String

模型参数量(如 7B、1.5B)


示例值:1
Tags.N Array of String

模型标签列表


示例值:["thisistag"]
StorageUri String

模型存储 URI(可选,如 cos://bucket-name/models/name/)


示例值:storageUri
UseCustomStorage Boolean

是否使用用户自带存储桶(默认 false 表示平台托管)


示例值:true
Tasks.N Array of String

任务类型列表(如 ["Text Generation", "Embedding"])


示例值:["thisistask"]
ModelUid String

模型 UID(可选,前端预先生成的 UID,不传则后端自动生成)


示例值:thisismodelUid12345

3. 输出参数

参数名称 类型 描述
ModelId String

模型ID


注意:此字段可能返回 null,表示取不到有效值。
示例值:60
ModelUid String

模型UID


示例值:thisismodelUid12345
Name String

模型名称


示例值:capi_test_123
Provider String

模型提供方


示例值:personal
Description String

模型描述


示例值:description
ModelType String

模型类型


示例值:ML
ParameterSize String

参数大小


示例值:1
Tags Array of String

模型标签


示例值:["thisistag"]
LatestVersion String

最新版本


示例值:v1
VersionCount Integer

版本总数


示例值:1
ServiceCount Integer

关联的推理服务数量


示例值:0
HasStorage Boolean

是否有存储


示例值:true
HasCustomStorage Boolean

是否使用用户自带存储桶


示例值:true
StorageType String

存储后端类型


示例值:COS
BuiltIn Boolean

是否内置模型


示例值:false
Tasks Array of String

任务类型列表


示例值:["thisistask"]
AppId Integer

APPID


示例值:260200066
CreateTime Integer

创建时间


示例值:1781579668983
UpdateTime Integer

更新时间


示例值:1781579668983
SubAccountUin String

Sub UIN


示例值:700002655694
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 示例

输入示例

POST / HTTP/1.1
Host: dlc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateInferenceModel
<公共请求参数>

{
    "Name": "capi_test_123",
    "ModelType": "ML",
    "InitialVersion": "v1",
    "Provider": "personal",
    "Description": "description",
    "ParameterSize": "1",
    "Tags": [
        "thisistag"
    ],
    "StorageUri": "storageUri",
    "UseCustomStorage": true,
    "Tasks": [
        "thisistask"
    ],
    "ModelUid": "thisismodelUid12345"
}

输出示例

{
    "Response": {
        "AppId": 260200066,
        "BuiltIn": false,
        "CreateTime": 1781579668983,
        "Description": "description",
        "HasCustomStorage": true,
        "HasStorage": true,
        "LatestVersion": "v1",
        "ModelId": "60",
        "ModelType": "ML",
        "ModelUid": "thisismodelUid12345",
        "Name": "capi_test_123",
        "ParameterSize": "1",
        "Provider": "personal",
        "ServiceCount": 0,
        "StorageType": "COS",
        "SubAccountUin": "700002655694",
        "Tags": [
            "thisistag"
        ],
        "Tasks": [
            "thisistask"
        ],
        "UpdateTime": 1781579668983,
        "VersionCount": 1,
        "RequestId": "48031f8c-c648-4cfb-8237-d9d219149211"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.ExternalService 外部服务异常