MaaS标准API V2

API地址

调用模型服务的API地址。

https://api.modelarts-maas.com/v2/chat/completions

鉴权请求头

向服务器提供身份验证/授权凭证。

"Authorization"："Bearer $MaaS_API_Key"

openPangu

openPangu-2.0-Flash

西南-贵阳一

openpangu-2.0-flash

GLM

GLM-5

西南-贵阳一

glm-5

GLM-5.1

西南-贵阳一

glm-5.1

GLM-5.2

西南-贵阳一

glm-5.2

Kimi

Kimi-K2.6

西南-贵阳一

kimi-k2.6

DeepSeek

DeepSeek-V4-Pro

西南-贵阳一

deepseek-v4-pro

DeepSeek-V4-Flash

西南-贵阳一

deepseek-v4-flash

DeepSeek-V3

西南-贵阳一

DeepSeek-V3

DeepSeek-R1-0528

西南-贵阳一

deepseek-r1-250528

DeepSeek-V3.1

西南-贵阳一

deepseek-v3.1-terminus

DeepSeek-V3.2

西南-贵阳一

deepseek-v3.2

Qwen3

Qwen3-235B-A22B

西南-贵阳一

qwen3-235b-a22b

Qwen3-32B

西南-贵阳一

qwen3-32b

Qwen3-30B-A3B

西南-贵阳一

qwen3-30b-a3b

通用

model

string

是

参数解释：

用于生成内容的模型ID。model取值请参见支持模型中的model参数值。

约束限制：

不涉及。

取值范围：

取值请参考支持模型中的model参数值。

默认取值：

不涉及。

messages

object[]

是

参数解释：

对话组成的消息列表。不同模型支持不同类型的消息。消息结构请参考系统消息、用户消息、模型答复消息和工具消息。

约束限制：

不涉及。

系统消息

（System Message）

messages.role

string

是

参数解释：

发送消息的角色。

约束限制：

不涉及。

取值范围：

system：系统发送的消息

默认取值：

不涉及。

messages.content

string/object[]

是

参数解释：

角色发送的消息内容。

约束限制：

不涉及。

messages.content.type

string

是

参数解释：

角色发送的消息的类型。

约束限制：

不涉及。

取值范围：

text：文本类型

默认取值：

不涉及。

messages.content.text

string

是

参数解释：

文本消息的内容。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

用户消息

（User Message）

messages.role

string

是

参数解释：

发送消息的角色。

约束限制：

不涉及。

取值范围：

user：用户发送的消息。

默认取值：

不涉及。

messages.content

string/object[]

是

参数解释：

角色发送的消息内容。

约束限制：

不涉及。

messages.content.type

string

是

参数解释：

角色发送的消息的类型。

约束限制：

不涉及。

取值范围：

text：文本类型

默认取值：

不涉及。

messages.content.text

string

是

参数解释：

文本消息的内容。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

模型答复消息

（Assistant Message）

messages.role

string

是

参数解释：

发送消息的角色。

约束限制：

不涉及。

取值范围：

assistant：模型回复的消息

默认取值：

不涉及。

messages.content

string/object[]

是

参数解释：

角色发送的消息内容。

约束限制：

不涉及。

messages.reasoning_content

string

否

参数解释：

模型回复消息中的思维链内容。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

messages.tool_calls

array

否

参数解释：

历史对话中，模型回复的工具调用信息。

约束限制：

不涉及。

messages.tool_calls.id

string

是

参数解释：

模型调用的工具的ID。

约束限制：

当发送消息的角色是工具，也就是参数“messages.role”取值为“tool”时，该参数必传。

取值范围：

不涉及。

默认取值：

不涉及

messages.tool_calls.type

string

是

参数解释：

工具类型。

约束限制：

不涉及。

取值范围：

function：函数调用

默认取值：

不涉及。

messages.tool_calls.function

object

是

参数解释：

模型调用工具对应的函数信息。

约束限制：

不涉及。

messages.tool_calls.function.arguments

string

是

参数解释：

模型生成的用于调用函数的JSON格式的参数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

messages.tool_calls.function.name

string

是

参数解释：

模型需要调用的函数名称。用户自定义的函数名称。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

不涉及。

messages.prefix

boolean

否

参数解释：

控制是否开启续写模式：用户提供assistant开头的消息，让模型基于该开头和输入指令来补全其余的部分。

约束限制：

使用该功能时，需确保messages列表里最后一条消息的role为assistant，并设置最后一条消息的prefix参数为tTrue，示例如下：

messages = [ {"role": "user", "content": "写一段python代码"}, {"role": "assistant", "content": "```python\n", "prefix": tTrue} ]

取值范围：

• true：开启续写模式
• false：关闭续写模式

默认取值：

false

工具消息

（Tool Message）

messages.role

string

是

参数解释：

发送消息的角色。

约束限制：

不涉及

取值范围：

tool：Function Call发送的消息。

默认取值：

不涉及。

messages.tool_call_id

string

是

参数解释：

模型调用的工具的ID。

约束限制：

当发送消息的角色是工具，也就是参数“messages.role”取值为“tool”时，该参数必传。

取值范围：

不涉及。

默认值：

不涉及。

messages.content

string/object[]

是

参数解释：

当前角色发送出的消息内容。

默认取值：

不涉及。

深度思考控制

thinking

object

否

参数解释：

控制模型是否开启或关闭深度思考模式。

约束限制：

不涉及。

thinking.type

string

是

参数解释：

开启或关闭深度思考模式。

约束限制：

不涉及。

取值范围：

• enabled：开启思考模式，模型一定先思考后回答。
• disabled：关闭思考模式，模型直接回答问题，不会进行思考。

默认取值：

默认值：不同模型的默认值不同，详情请参见深度思考模型思考控制开关支持情况。

模型输出行为配置

max_completion_tokens

integer/null

否

参数解释：

控制模型输出的最大长度，包括两部分：模型回答（content部分）和模型思维链部分（reasoning_content）。

配置该参数后，模型输出的Token长度不会超过max_completion_tokens配置的值。

约束限制：

• 不可与max_tokens字段同时设置，否则会直接报错。
• 深度思考模型在关闭了思考模式的情况max_completions_tokens依然生效，只控制content部分的输出Token长度。

取值范围：

各个模型取值不同，详情请参见MaaS控制台模型详情页的最大输出长度和最大思维链长度。

默认取值：

不涉及。

max_tokens

integer/null

否

参数解释：

模型回答最大长度，单位为Token。

约束限制：

• 模型回答不包含思维链内容。

  模型回答=模型输出-模型思维链（如有）。

• 输出Token的总长度还受模型的上下文长度限制。

取值范围：

各个模型取值不同，详情请参见MaaS控制台模型详情页的最大输出长度。

默认取值：

Kimi-K2.6为32K，其它模型为4K。

temperature

float/null

否

参数解释：

采样温度，用于控制模型生成内容的随机性。

较高的值（如大于1）会使模型输出更加随机、发散、创造性高，而较低的值（如 0.1）会使输出更加集中确定、保守。

约束限制：

建议仅调整temperature或top_p其中之一，不建议两者都修改。

取值范围：

[0,2]

默认取值：

DeepSeek-V3、DeepSeek-R1-0528和DeepSeek-V4系列会对输入值做特殊处理：

• DeepSeek-V3：当temperature≤1时，乘以0.3；当temperature>1时，减去0.7；值为空时，默认为0.6。
• DeepSeek-R1-0528：无论用户输入值多少均为0.6。
• DeepSeek-V4系列：思考模式下，无论用户输入值多少均为1.0。

Kimi-K2.6会对输入值做特殊处理：思考模式下，无论用户输入值多少均为1.0；非思考模式下，无论用户输入值多少均为0.6。

openPangu-2.0-Flash模型默认值为1。

其它模型如果有输入值，以输入值为准；如果输入值为空，则默认为0.6。

top_p

float/null

否

参数解释：

核采样概率阈值，用于控制模型生成内容的多样性，和temperature参数类似，但原理不同，可以更精细地控制模型输出的词汇范围。

设置值接近0时，模型只从概率最高的极少数词中采样，输出非常保守、确定性强。设置值接近1时，则几乎不限制词库，输出更随机、更发散。

约束限制：

建议仅调整temperature或top_p其中之一，不建议两者都修改。

取值范围：

(0,1]

默认取值：

• Kimi-K2.6：思考模式和非思考模式均为0.95，不支持修改。
• DeepSeek-V4系列：思考模式下，无论用户输入值多少均为1.0。
• 其它模型0.7。

top_k

integer

否

参数解释：

控制模型生成时每次只从概率最高的k个词里挑选，用来控制生成文本的随机性。取值越大，生成的随机性越高；取值越小，生成的确定性越高。

约束限制：

不涉及。

取值范围：

>=0

默认取值：

不涉及。

logprobs

boolean/null

否

参数解释：

对数概率。控制模型是否返回输出Token的对数概率。

约束限制：

不涉及。

取值范围：

• true：开启返回对数概率的功能。
• false：关闭返回对数概率的功能。

默认取值：

false

top_logprobs

integer/null

否

参数解释：

对数概率个数。如果值为N，则控制模型返回N个输出Token的对数概率。

约束限制：

仅当参数logprobs值为true时该参数才生效。

取值范围：

[0, 20]之间的整数

默认取值：

0

frequency_penalty

number/null

否

参数解释：

频率惩罚系数，是一个用于控制模型输出多样性的重要参数。

根据词语已经出现的次数，按比例降低该词再次出现的概率。出现的次数越多，再次被使用的概率就越低。

约束限制：

DeepSeek-V4系列：不支持该参数。

取值范围：

[-2,2]

• 0：不做任何惩罚。
• 正值：增加惩罚，值越大，模型越倾向于引入新的词汇和话题，避免内容重复。
• 负值：减少惩罚（实际上是奖励）。模型更倾向于重复使用已经出现过的词汇，这通常会导致文本极其啰嗦和重复（一般不推荐使用）。

默认取值：

0

presence_penalty

number/null

否

参数解释：

存在惩罚系数，是一个用于控制模型输出多样性的重要参数。降低模型重复谈论已经出现过的话题或词汇的概率，从而鼓励模型去谈论“新事物”。

只要某个词在之前已经生成的文本中出现过至少一次，模型就会对该词施加一个固定的惩罚，降低它再次被选中的概率。模型会根据新Token截止目前是否已出现对其进行惩罚。如果值为正，会增加模型生成新内容的可能性。

约束限制：

DeepSeek-V4系列：不支持该参数。

取值范围：

[-2,2]

• 0：不做任何惩罚
• 正值：增加惩罚，值越大，模型越倾向于引入新的词汇和话题，避免内容重复。
• 负值：减少惩罚（实际上是奖励）。模型更倾向于重复使用已经出现过的词汇，这通常会导致文本极其啰嗦和重复（一般不推荐使用）。

默认取值：

0

logit_bias

map/null

否

参数解释：

逻辑偏置。调整指定Token在模型输出内容中出现的概率。输入为JSON对象，该对象将Token映射到一个范围为[-100, 100]的相关偏置值 。

值越小则可能性越低，越高则会增加选择的可能性。

示例：{Token ID：偏置值，Token ID：偏置值，...} 。Token ID是指某个特定词的数字ID。

约束限制：

带深度思考能力模型不支持该字段。

取值范围：

偏置值取值范围为[-100, 100]。

-100：完全禁止选择该Token，

100：会导致仅可选择该Token。

该参数的实际效果可能因模型而异。

默认取值：

null

stream

boolean/null

否

参数解释：

响应内容是否流式返回。

约束限制：

不涉及

取值范围：

• false：模型生成完所有内容后一次性返回结果。
• true：逐块返回模型生成内容，最后以data: [DONE]结束消息。

默认取值：

false

stream_options

object/null

否

参数解释：

流式响应的选项。

约束限制：

当stream为true时，可设置stream_options字段。

stream_options.include_usage

boolean

否

参数解释：

模型流式输出时，是否在输出结束前输出本次请求的Token用量信息。

约束限制：

当前暂不支持关闭。

取值范围：

true：在data: [DONE]消息之前会返回一个额外的chunk。此chunk中， usage字段中输出整个请求的Token用量，choices字段为空数组。

默认取值：

true

stop

string/string[]/null

否

参数解释：

当模型遇到stop字段中所指定的字符串时将停止继续生成，这个字符本身也不会出现在响应中。停止Token不会命中思维链中的Token，仅会命中正式回答content中的部分。

约束限制：

最多支持4个字符串。

取值范围：

不涉及。

默认取值：

不涉及。

reasoning_effort

string

否

参数解释：

控制思考强度的参数。

约束限制：

思考模式下该字段才生效。

涉及的模型：DeepSeek-V4系列、GLM-5.2

取值范围：

• high

默认取值：

high

工具调用

tools

object[]/null

否

参数解释：

待调用工具的列表，模型返回信息中可包含。当您需要让模型返回待调用工具时，需要配置该结构体。

约束限制：

不涉及

tools.type

string

是

参数解释：

工具类型。

约束限制：

不涉及。

取值范围：

function：函数调用

默认取值：

不涉及。

tools.function

object

是

参数解释：

模型返回内容中包含待调用的工具。

约束限制：

不涉及。

tools.function.name

string

是

参数解释：

调用的函数的名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

tools.function.description

string

否

参数解释：

调用的函数的描述，模型会基于该描述判断当前任务是否需要使用该工具。

约束限制：

不涉及。

取值范围：

不涉及

默认取值：

不涉及。

tools.function.parameters

object

否

参数解释：

函数请求参数，以JSON格式描述。示例如下：

{
"type": "object",
"properties": {
"参数名": {
"type": "参数类型",
"description": "参数说明"
}
},
"required": ["必填参数"]
}

parameters必须符合JSON规范。

约束限制：

不涉及。

tool_choice

string/object

否

参数解释：

控制模型调用工具的模式。

对应模型支持的类型请参考工具调用模型支持情况。

约束限制：

不涉及

取值范围：

• none ：不调用任何工具。
• auto ：模型自行判断是否进行工具调用。
• 指定函数调用（named）：模型必须调用指定的函数，通过 tool_choice.type 和 tool_choice.function 字段指定必须调用的函数。

默认取值：

• 有提供工具：auto。当未提供待调用工具列表时默认为none。
• 当有提供待调用工具列表时默认为auto。

tool_choice.type

string

是

参数解释：

调用的类型指定模型需要调用的工具类型，此处应为function。

约束限制：

不涉及。

取值范围：

function：函数调用

默认取值：

不涉及。

tool_choice.function

object

是

参数解释：

指定模型需要调用的函数信息。

约束限制：

不涉及。

tool_choice.function.name

string

是

参数解释：

指定模型需要调用的函数名称，应在待调用工具列表中声明函数定义。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

created

integer

参数解释：

本次请求创建时间的Unix时间戳（秒）。

取值范围：

不涉及。

id

string

参数解释：

本次请求的唯一标识。

取值范围：

不涉及。

model

string

参数解释：

本次请求使用的模型ID。

取值范围：

本次请求使用的模型ID。

object

string

参数解释：

模型API类型。

取值范围：

固定为chat.completion。

choices

object[]

参数解释：

本次请求的模型输出内容。

choices.finish_reason

string

参数解释：

模型停止生成的原因：

取值范围：

• stop：模型输出自然结束，或命中了请求参数stop中指定的字段。
• length：模型输出触发max_tokens限制（思维链内容+回答内容的长度限制）。
• tool_calls：模型触发了工具调用。

choices.index

integer

参数解释：

当前元素在choices列表的索引。

取值范围：

不涉及。

choices.message

object

参数解释：

模型输出的内容。

choices.message.role

string

参数解释：

内容输出的角色。

取值范围：

• assistant：模型回复的消息
• tool：Function Call发送的消息

choices.message.content

string

参数解释：

模型生成的消息内容。

取值范围：

不涉及。

choices.message.reasoning_content

string/null

参数解释：

模型生成的思维链内容，仅深度思考模型返回此字段。

取值范围：

不涉及。

choices.message.tool_calls

object[]/null

参数解释：

模型生成的工具调用信息，触发了工具调用才会返回该参数。

choices.message.tool_calls.id

string

参数解释：

调用的工具的ID。

取值范围：

不涉及。

choices.message.tool_calls.type

string

参数解释：

工具类型。

取值范围：

工具类型，当前仅支持function：函数调用。

choices.message.tool_calls.function

object

参数解释：

模型调用的函数。

choices.message.tool_calls.function.name

string

参数解释：

模型调用的函数的名称。

取值范围：

不涉及。

choices.message.tool_calls.function.arguments

string

参数解释：

模型生成的用于调用函数的JSON格式输入。

取值范围：

不涉及。

choices.logprobs

object/null

参数解释：

当前内容的对数概率信息。

choices.logprobs.content

object[]/null

参数解释：

模型返回的消息内容中每个Token的对数概率信息。

choices.logprobs.content.token

string

参数解释：

模型返回的消息内容中的Token。

取值范围：

不涉及。

choices.logprobs.content.logprob

float

参数解释：

模型返回的消息内容中的Token的对数概率。

取值范围：

不涉及。

choices.logprobs.content.bytes

integer[]/null

参数解释：

当前Token的UTF-8值，为一个整数列表。如果Token没有UTF-8值则为空。

choices.logprobs.content.top_logprobs

object[]

参数解释：

在当前Token位置上概率最高的候选Token及其对数概率的列表。

choices.logprobs.content.top_logprobs.token

string

参数解释：

候选Token。

取值范围：

不涉及。

choices.logprobs.content.top_logprobs.logprob

float

参数解释：

候选Token的对数概率。

取值范围：

不涉及。

choices.logprobs.content.top_logprobs.bytes

integer[]/null

参数解释：

候选Token的UTF-8值，为一个整数列表。如果Token没有UTF-8值则为空。

usage

object

参数解释：

本次请求的Token用量信息。

usage.completion_tokens

integer

参数解释：

模型输出内容消耗的Token数量。

取值范围：

不涉及。

usage.prompt_tokens

integer

参数解释：

模型处理输入内容消耗的Token数量。

取值范围：

不涉及。

输入给模型处理的内容Token数量。

usage.total_tokens

integer

参数解释：

本次请求消耗的总Token数量（输入+输出）。

取值范围：

不涉及。

usage.completion_tokens_details

object

参数解释：

模型输出内容消耗的Token详情。

usage.completion_tokens_details.reasoning_tokens

integer

参数解释：

输出思维链内容消耗的Token数。

取值范围：

不涉及。

usage.prompt_tokens_details

object

参数解释：

给模型输入的Token数量的详细信息。

usage.prompt_tokens_details.cached_tokens

integer

参数解释：

缓存输入内容的Token用量。

取值范围：

不涉及。

service_tier

string

参数解释：

本次请求使用的服务层级。

取值范围：

default。

created

integer

参数解释：

本次请求创建时间的Unix时间戳（秒）。

取值范围：

不涉及。

id

string

参数解释：

本次请求的唯一标识。

取值范围：

不涉及。

model

string

参数解释：

本次请求实际使用的模型ID。

取值范围：

本次请求实际使用的模型ID

object

string

参数解释：

固定为chat.completion.chunk。

choices

object[]

参数解释：

本次请求的模型输出内容。

choices.finish_reason

string

参数解释：

模型停止生成Token的原因。

取值范围：

• stop：模型输出自然结束，或因命中请求参数stop中指定的字段而被截断。
• length：模型输出因达到模型输出限制而被截断。
• tool_calls：模型调用了工具。

choices.index

integer

参数解释：

当前元素在choices列表的索引。

取值范围：

不涉及。

choices.delta

object

参数解释：

模型输出的增量内容。

choices.delta.role

string

参数解释：

内容输出的角色。

取值范围：

• system：系统发送的消息
• user：用户发送的消息
• assistant：模型回复的消息
• tool：Function Call发送的消息

choices.delta.content

string

参数解释：

模型生成的消息内容。

取值范围：

不涉及。

choices.delta.reasoning_content

string/null

参数解释：

模型处理问题的思维链内容。

取值范围：

不涉及。

choices.delta.tool_calls

object[]/null

参数解释：

模型生成的工具调用信息。

choices.message.tool_calls.id

string

参数解释：

调用的工具的ID。

取值范围：

不涉及。

choices.message.tool_calls.type

string

参数解释：

工具类型。

取值范围：

function：函数调用

choices.message.tool_calls.function

object

参数解释：

模型调用的函数。

choices.message.tool_calls.function.name

string

参数解释：

模型调用的函数的名称。

取值范围：

不涉及。

choices.message.tool_calls.function.arguments

string

参数解释：

模型生成的用于调用函数的参数，格式为JSON。

模型并不总是生成有效的JSON，并且可能会虚构出一些您的函数参数规范中未定义的参数。在调用函数之前，请在您的代码中验证这些参数是否有效。

取值范围：

不涉及。

choices.logprobs

object/null

参数解释：

当前内容的对数概率信息。

choices.logprobs.content

object[]/null

参数解释：

模型返回的消息内容中每个Token的对数概率信息。

choices.logprobs.content.token

string

参数解释：

模型返回的消息内容中的Token。

取值范围：

不涉及。

choices.logprobs.content.logprob

float

参数解释：

模型返回的消息内容中的Token的对数概率。

取值范围：

不涉及。

choices.logprobs.content.bytes

integer[]/null

参数解释：

当前Token的UTF-8值，为一个整数列表。如果Token没有UTF-8值则为空。

choices.logprobs.content.top_logprobs

object[]

参数解释：

在当前Token位置上概率最高的候选Token及其对数概率的列表。

choices.logprobs.content.top_logprobs.token

string

参数解释：

候选Token。

取值范围：

不涉及。

choices.logprobs.content.top_logprobs.logprob

float

参数解释：

候选Token的对数概率。

取值范围：

不涉及。

choices.logprobs.content.top_logprobs.bytes

integer[]/null

参数解释：

候选Token的UTF-8值，为一个整数列表。如果Token没有UTF-8值则为空。

usage

object

参数解释：

本次请求的Token用量。

usage.completion_tokens

integer

参数解释：

模型输出内容所消耗的Token数量。

取值范围：

不涉及。

usage.prompt_tokens

integer

参数解释：

模型处理输入的内容所消耗的Token数量。

取值范围：

不涉及。

usage.total_tokens

integer

参数解释：

本次请求消耗的总Token数量（输入+输出）。

取值范围：

不涉及。

usage.completion_tokens_details

object

参数解释：

模型输出内容消耗的Token详情。

usage.completion_tokens_details.reasoning_tokens

integer

参数解释：

输出思维链内容消耗的Token数。

取值范围：

不涉及。

usage.prompt_tokens_details

object

参数解释：

输入给模型的Token数量的细节。

usage.prompt_tokens_details.cached_tokens

integer

参数解释：

缓存输入内容的Token用量。

取值范围：

不涉及。

service_tier

string

参数解释：

本次请求使用的服务层级。

取值范围：

default。

first_token_return_time

float

参数解释：

该chunk首Token返回时间。

取值范围：

不涉及。

openPangu-2.0-Flash

enabled

• enabled
• disabled

DeepSeek-V4-Flash

DeepSeek-V4-Pro

enabled

• enabled
• disabled

DeepSeek-R1-0528

enabled

enabled

DeepSeek-V3.1

disabled

• enabled
• disabled

DeepSeek-V3.2

disabled

• enabled
• disabled

Qwen3-235B-A22B

enabled

• enabled
• disabled

Qwen3-32B

Qwen3-30B-A3B

GLM-5

enabled

• enabled
• disabled

GLM-5.1

enabled

• enabled
• disabled

GLM-5.2

enabled

• enabled
• disabled

Kimi-K2.6

enabled

• enabled
• disabled

openPangu-2.0-Flash

• none
• auto

GLM-5.1

GLM-5.2

• none
• auto
• 指定的函数

GLM-5

• none
• auto

Kimi-K2.6

• none
• auto

DeepSeek-V4-Flash

DeepSeek-V4-Pro

DeepSeek-V3.2

DeepSeek-R1-0528

• none
• auto
• 指定的函数

DeepSeek-V3

DeepSeek-V3.1

• auto
• 指定的函数

Qwen3-235B-A22B

• none
• auto
• 指定的函数