ModelRouterCreateBillingRule - 计费管理/创建计费规则-智能科教内容生成平台(SSECP)-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
aicontent:ModelRouterCreateBillingRule	create	全部资源 ``	无	无

请求语法

POST /api/v1/modelRouter/open/billing/rules HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	计费规则创建请求
modelId	long	是	模型 ID	1
billingType	string	否	计费类型：configurable	configurable
pricingConfig	any	否	pricingConfig 为 JSON 对象，其内部字段结构根据计费类型不同而变化。 Token 阶梯计费适用于 Chat 类模型。按输入 Token 数量分阶梯计价，支持常规模式、思考模式、缓存命中三种价格维度。JSON 格式： json { "tiers": [ { "min_tokens": 0, "max_tokens": 32000, "input_price": 2.5, "output_price": 10, "thinking_input_price": 2.5, "thinking_output_price": 10, "cached_input_price": 2.5 }, { "min_tokens": 32000, "max_tokens": 128000, "input_price": 4, "output_price": 16, "thinking_input_price": 4, "thinking_output_price": 16, "cached_input_price": 4 } ] } 字段说明：字段类型必填语义单位 tiers array 是阶梯定价数组，至少一个元素 - tiers[].min_tokens integer 是当前阶梯 Token 数量下限（含） Token tiers[].max_tokens integer 是当前阶梯 Token 数量上限（不含），0 表示不限 Token tiers[].input_price number 是常规模式输入 Token 单价元 / 百万 Token tiers[].output_price number 是常规模式输出 Token 单价元 / 百万 Token tiers[].thinking_input_price number 否思考模式输入 Token 单价元 / 百万 Token tiers[].thinking_output_price number 否思考模式输出 Token 单价元 / 百万 Token tiers[].cached_input_price number 否缓存命中时输入 Token 单价元 / 百万 Token 约束：第一个阶梯的 min_tokens 必须为 0 非最后一个阶梯的 max_tokens 必须大于 min_tokens 相邻阶梯必须连续衔接（前一阶梯 max_tokens = 后一阶梯 min_tokens），不允许重叠或间隙按图片计费适用于 ImageGeneration、ImageEdit 类模型。按生成/处理图片的张数计价。JSON 格式： json { "price_per_image": 0.2 } 字段说明：字段类型必填语义单位 price_per_image number 是每张图片的计费单价元 / 张视频矩阵计费适用于 VideoGeneration、VideoImageGeneration 类模型。按视频分辨率和是否有音频两个维度组合定价。注意：前端交互时使用 matrix 字段，但调用 API 保存时需使用 tiers 字段（matrix 会在服务端自动转换）。以下给出的是 API 侧的标准格式。 JSON 格式： json { "tiers": [ { "resolution": 480, "has_audio": 0, "price_per_second": 0.24 }, { "resolution": 480, "has_audio": 1, "price_per_second": 0.24 }, { "resolution": 720, "has_audio": 0, "price_per_second": 0.24 }, { "resolution": 720, "has_audio": 1, "price_per_second": 0.24 } ], "default_price_per_second": 0.24 } 字段说明：字段类型必填语义单位 tiers array 是视频矩阵定价数组 - tiers[].resolution integer 是视频分辨率，取值：480、720、1080 像素高度（p） tiers[].has_audio integer 是是否包含音频，取值：0（无声）、1（有声） - tiers[].price_per_second number 是该组合下的每秒单价元 / 秒 default_price_per_second number 否未匹配到矩阵项时的默认每秒单价元 / 秒约束： resolution 仅支持 480p、720p、1080p resolution + has_audio 组合不可重复按时长计费适用于 ASR（语音识别）类模型。按音频时长计价。JSON 格式： json { "price_per_unit": 0.00022 } 字段说明：字段类型必填语义单位 price_per_unit number 是音频每秒计费单价元 / 秒按字符计费适用于 TTS（语音合成）类模型。按合成文本的字符数计价。JSON 格式： json { "price_per_unit": 0.8 } 字段说明：字段类型必填语义单位 price_per_unit number 是每万字符计费单价元 / 万字符 Token 统一计费适用于 Embedding、Rerank、MultimodalEmbedding、MultimodalRerank 类模型。不区分阶梯，按统一单价计费。JSON 格式： json { "input_price": 0.5, "multimodal_input_price": 0.5 } 字段说明：字段类型必填语义单位 input_price number 是纯文本输入 Token 单价元 / 百万 Token multimodal_input_price number 否多模态输入 Token 单价元 / 百万 Token 全模态多维度计费适用于 ChatFullmodal 类全模态模型（如 qwen3.5-omni-plus）。对文本、音频、图片、视频等不同模态的输入和输出分别定价。JSON 格式： json { "text_input_price": 7, "audio_input_price": 53, "image_input_price": 7, "video_input_price": 7, "text_output_price": 40, "audio_output_price": 213, "multi_text_output_price": 0 } 字段说明：字段类型必填语义单位 text_input_price number 是文本输入 Token 单价元 / 百万 Token audio_input_price number 是音频输入 Token 单价元 / 百万 Token image_input_price number 否图片输入 Token 单价元 / 百万 Token video_input_price number 否视频输入 Token 单价元 / 百万 Token text_output_price number 是文本输出 Token 单价元 / 百万 Token audio_output_price number 否音频输出 Token 单价元 / 百万 Token multi_text_output_price number 否多模态输入后的文本输出 Token 单价（当输入包含图片/音频/视频时，文本输出的单独计价）元 / 百万 Token	{ "tiers":[ { "input_price":2.5, "cached_input_price":2.5, "max_tokens":32000, "output_price":10, "thinking_output_price":10, "thinking_input_price":2.5, "min_tokens":0 }, { "input_price":4, "cached_input_price":4, "max_tokens":128000, "output_price":16, "thinking_output_price":16, "thinking_input_price":4, "min_tokens":32000 }, { "input_price":7, "cached_input_price":7, "max_tokens":252000, "output_price":28, "thinking_output_price":28, "thinking_input_price":7, "min_tokens":128000 } ] }
effectiveTime	string	否	生效时间，RFC3339 格式	2024-01-01T00:00:00Z
expireTime	string	否	过期时间，RFC3339 格式	2025-01-01T00:00:00Z
version	integer	否	计费规则版本号	1

返回参数

名称	类型	描述	示例值
	object	OpenApiSingleResponse
requestId	string	请求编号	xxxx-xxxx-xxxx-xxxxxxxx
success	boolean	是否成功	true
errCode	string	错误信息编码	UNKNOWN_ERROR
errMessage	string	错误信息	未知错误
httpStatusCode	integer	http 状态码	200
data	object	返回数据
id	long	规则 ID	1
modelId	long	模型 ID	1
modelCode	string	模型标识	qwen-plus
modelName	string	模型名称	通义千问Plus
modelType	string	模型类型	chat
symbol	string	厂商标识	alibaba
billingType	string	计费类型	token_tiered
pricingConfig	any	计费配置	{}
effectiveTime	string	生效时间	2024-01-01T00:00:00Z
expireTime	string	过期时间	2025-01-01T00:00:00Z
version	integer	版本号	1
deleteTag	integer	删除标记	0
gmtCreate	string	创建时间	2024-01-01T00:00:00Z
gmtModified	string	修改时间	2024-01-01T00:00:00Z

示例

正常返回示例

JSON格式

{
  "requestId": "xxxx-xxxx-xxxx-xxxxxxxx",
  "success": true,
  "errCode": "UNKNOWN_ERROR",
  "errMessage": "未知错误",
  "httpStatusCode": 200,
  "data": {
    "id": 1,
    "modelId": 1,
    "modelCode": "qwen-plus",
    "modelName": "通义千问Plus",
    "modelType": "chat",
    "symbol": "alibaba",
    "billingType": "token_tiered",
    "pricingConfig": {},
    "effectiveTime": "2024-01-01T00:00:00Z",
    "expireTime": "2025-01-01T00:00:00Z",
    "version": 1,
    "deleteTag": 0,
    "gmtCreate": "2024-01-01T00:00:00Z",
    "gmtModified": "2024-01-01T00:00:00Z"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
200	B.Resource.NotFoundException	B.Resource.NotFoundException.	-
403	B.Permission.OrgNoExistException	B.Permission .OrgNoExistException.	鉴权失败-组织不存在
500	Server.Internal.UnknownError	The request processing has failed due to some unknown error.	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2026-04-23	新增 OpenAPI	查看变更详情