创建自定义接入点

功能介绍

在企业和开发者的AI应用开发与运营过程中，面临着推理服务调用管理无序、流量控制困难、成本核算模糊等问题。多个业务线共用同一推理服务，导致资源争抢、服务性能不稳定，同时缺乏有效的调用限制手段，难以追溯各业务模块的资源消耗情况。MaaS支持自定义接入点功能，通过创建独立的调用入口，允许用户设置限流规则，并基于自定义接入点名称实现费用的精准统计，帮助用户高效管理推理服务资源，优化使用成本。

接口约束

• 该功能仅支持“西南-贵阳一”区域。
• 最多同时存在10个自定义接入点。
• 同一账户下不允许存在同名的自定义接入点，已删除的接入点名称不允许新建时使用。
• 自定义接入点创建后，不支持修改模型服务。
• 创建的自定义接入点需遵循平台相关的规则和规范，不得进行违规调用。

计费说明

自定义接入点功能本身不收费。调用模型服务或使用资源可能会产生费用。您可以通过接入点名称在费用中心查询服务使用账单。

• 调用在线推理-预置服务：按Token计费，计费模式与所选基础模型的计费模式一致。关于计费详情，请参见模型服务价格。
• 调用AI开发平台ModelArts-在线服务：由ModelArts计费。关于计费详情，请参见ModelArts推理部署计费项。

前提条件

已在MaaS开通预置服务或在ModelArts创建在线服务。具体操作，请参见在ModelArts Studio（MaaS）开通预置服务。

URI

POST /v1/{project_id}/maas/services/custom-endpoint/endpoint

请求参数

响应参数

请求示例

• 使用DeepSeek-V3.1模型创建custom_from_maas类型自定义接入点示例如下。 您可以根据实际业务需求，替换为其他模型和数据文件。

  /v1/{project_id}/maas/services/custom-endpoint/endpoint
  
  {
  "model_name": "DeepSeek-V3.1 ",
  "endpoint_name": "DeepSeek-Test",
  "remark": "DeepSeek自定义接入点测试",
  "source": "custom_from_maas",
  "moderation": true,
  "tpm": 0,
  "rpm": 0,
  "agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62b6c6"
  }
  

• 创建custom_from_modelarts_v2类型自定义接入点示例如下。 您可以根据实际业务需求，替换为其他模型和数据文件。

  /v1/{project_id}/maas/services/custom-endpoint/endpoint
  
  {
  	"endpoint_name": "test_endpoint",
  	"source": "custom_from_modelarts_v2",
  	"moderation": true,
  	"agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62b6c6",
  	"region": "cn-southwest-2",
  	"infer_service_id": "1b27760b-f9d9-42f1-8eea-e68aba09f039",
  	"workspace_id": "0"
  }

响应示例

• 使用DeepSeek-V3.1模型创建custom_from_maas类型自定义接入点，响应示例如下：
  • 成功响应，状态码：200

    {
    "id": "c4513589-df2e-4d58-ab0c-d5a6f2******",  
    "served_model_name": "deepseek-v3.1-4ZGlnU",
    "created_at": "2025-12-09T11:32:46Z"
    }

  • 失败响应，状态码：400

    {  
    "error_code": "ModelArts.0103", 
    "error_msg": "error reason"
     }

• 创建custom_from_modelarts_v2类型自定义接入点，响应示例如下：
  • 成功响应，状态码：200

    {
    "id": "c4513589-df2e-4d58-ab0c-d5a6f2******",  
    "served_model_name": "dpsk-v3-vllm-a3-02-4ZGlnU",
    "created_at": "2025-12-09T11:32:46Z"
    }

  • 失败响应，状态码：400

    {  
    "error_code": "ModelArts.0103", 
    "error_msg": "error reason"
     }

状态码

请参见状态码。

错误码

请参见错误码。