不同协议不能混用请求体。OpenAI 兼容接口使用
https://moxus.cloud/v1，Anthropic 兼容接口使用 https://moxus.cloud，Google 兼容接口使用 https://moxus.cloud/v1beta。通用字段
| 参数 | 类型 | 必填 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|---|
model | string | 是 | 无 | - | 要调用的模型名称。请从“模型广场”复制完整名称。 |
messages | array | Chat / Claude 必填 | 无 | - | 多轮对话消息。OpenAI 与 Anthropic 的消息结构略有差异。 |
input | string / array / object | Responses 常用 | 无 | - | Responses API 和部分模型的输入字段。 |
prompt | string / array | 部分补全或图像接口使用 | 无 | - | 单轮提示词或图像生成提示词。 |
stream | boolean | 否 | false | true / false | 是否以流式方式返回结果。 |
metadata | object | 否 | 无 | - | 自定义元数据，便于业务侧追踪。不要放敏感信息。 |
user | string / object | 否 | 无 | - | 客户端用户标识。部分上游支持，部分上游会忽略。 |
采样与长度
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
temperature | number | 模型默认 | [0, 2] | 控制随机性。越低越稳定，越高越发散。 |
top_p | number | 模型默认 | [0, 1] | 核采样阈值。一般不要同时大幅调整 temperature 和 top_p。 |
top_k | integer / number | 模型默认 | [1, +∞) | 限制候选 token 数。Anthropic 和 Google 常见，OpenAI 模型不一定支持。 |
max_tokens | integer | 模型默认 | [0, limit] | 限制输出 token 数。Chat Completions 和 Anthropic 常用。 |
max_completion_tokens | integer | 模型默认 | [0, limit] | OpenAI 部分新模型的输出上限字段。 |
max_output_tokens | integer | 模型默认 | [0, limit] | Responses API 和 Google 原生接口常用输出上限字段。 |
stop | string / array | 无 | - | OpenAI 兼容停止序列。遇到指定内容时停止生成。 |
stop_sequences | array | 无 | - | Anthropic / Google 原生停止序列。 |
n | integer | 1 | [1, +∞) | 返回候选结果数量。会增加成本，图像生成也使用该字段。 |
seed | number / integer | 无 | - | 尝试固定随机种子。可复现性取决于模型和上游。 |
OpenAI Chat Completions 参数
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
messages | array | 无 | system / user / assistant / tool | 对话消息列表。 |
response_format | object | 无 | json_object / json_schema | 要求模型返回 JSON 或符合 JSON Schema 的结构化输出。 |
tools | array | 无 | - | 声明可被模型调用的工具。 |
tool_choice | string / object | auto | auto / none / {...} | 控制模型是否调用工具或强制调用某个工具。 |
parallel_tool_calls | boolean | 模型默认 | true / false | 是否允许模型在一轮中并行发起多个工具调用。 |
logprobs | boolean | false | true / false | 是否返回 token 对数概率。并非所有模型支持。 |
top_logprobs | integer | 无 | [0, 20] | 返回每个位置的候选 token 对数概率数量。 |
frequency_penalty | number | 0 | [-2, 2] | 降低重复词频。正数会减少重复表达。 |
presence_penalty | number | 0 | [-2, 2] | 鼓励引入新主题。正数会提高话题多样性。 |
logit_bias | object | 无 | [-100, 100] | 调整指定 token 出现概率。需要 token ID。 |
modalities | array | 模型默认 | text / audio | 多模态输出类型。取决于模型支持。 |
audio | object | 无 | - | 音频输出配置。仅支持音频输出的模型可用。 |
OpenAI Responses 参数
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
input | string / array | 无 | - | Responses API 的主要输入字段。 |
instructions | string | 无 | - | 全局指令，作用类似 system prompt。 |
previous_response_id | string | 无 | - | 接续上一轮 Responses 对话。 |
max_output_tokens | integer | 模型默认 | [0, limit] | 限制输出 token 数。 |
reasoning | object | 模型默认 | - | 推理模型的思考配置。 |
text | object | 模型默认 | - | 文本输出格式配置。 |
tools | array / object | 无 | - | Responses API 工具配置。 |
tool_choice | string / object | auto | auto / none / {...} | 控制工具调用。 |
truncation | string | 模型默认 | auto / disabled | 输入过长时的截断策略。 |
include | array | 无 | - | 指定额外返回字段。 |
store | boolean | 上游默认 | true / false | 是否允许上游存储结果。平台可能按通道配置控制透传。 |
Anthropic 兼容参数
| 参数 | 类型 | 必填 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|---|
model | string | 是 | 无 | - | Claude 或 Anthropic 兼容模型名称。 |
messages | array | 是 | 无 | user / assistant | Claude Messages 对话内容。 |
system | string / array | 否 | 无 | - | 系统指令。 |
max_tokens | integer | 常用必填 | 无 | [0, limit] | 最大输出 token 数。 |
temperature | number | 模型默认 | [0, 1] | 控制随机性。部分 Claude 模型可能限制非默认采样参数。 | |
top_p | number | 模型默认 | [0, 1] | 核采样。 | |
top_k | integer | 模型默认 | [1, +∞) | 限制候选 token 数。 | |
stop_sequences | array | 无 | - | 停止序列。 | |
stream | boolean | false | true / false | 是否流式返回。 | |
tools | array | 无 | - | 声明 Claude 可调用工具。 | |
tool_choice | object | auto | auto / any / tool | 控制工具选择。 | |
thinking | object | 模型默认 | enabled / disabled | Claude 思考模式配置，取决于模型支持。 | |
metadata | object | 无 | - | 业务元数据。避免放敏感信息。 |
Google 兼容参数
Google 原生接口通常把生成参数放在generationConfig 中。Moxus AI 也兼容部分 snake_case 字段，例如 top_p、max_output_tokens。
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
contents | array / string | 无 | - | Google 原生主要输入内容。 |
systemInstruction | object / string | 无 | - | Google 原生系统指令。 |
tools | array / object | 无 | - | 工具或搜索能力声明。 |
generationConfig.temperature | number | 模型默认 | [0, 2] | 控制随机性。 |
generationConfig.topP / top_p | number | 模型默认 | [0, 1] | 核采样。 |
generationConfig.topK / top_k | number | 模型默认 | [1, +∞) | 候选 token 限制。 |
generationConfig.maxOutputTokens / max_output_tokens | integer | 模型默认 | [0, limit] | 输出 token 上限。 |
generationConfig.candidateCount | integer | 1 | [1, +∞) | 候选结果数量。 |
generationConfig.stopSequences | array | 无 | - | 停止序列。 |
generationConfig.responseMimeType | string | 无 | application/json / text/plain | 响应 MIME 类型。 |
generationConfig.responseSchema | object | 无 | - | 结构化输出 schema。 |
generationConfig.presencePenalty | number | 0 | [-2, 2] | 话题重复惩罚。 |
generationConfig.frequencyPenalty | number | 0 | [-2, 2] | 词频重复惩罚。 |
generationConfig.seed | integer | 无 | - | 随机种子。 |
generationConfig.thinkingConfig | object | 模型默认 | - | 思考预算或思考开关。 |
generationConfig.responseModalities | array | 模型默认 | TEXT / IMAGE | 输出模态。取决于模型支持。 |
图像生成参数
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
model | string | 无 | - | 要调用的图像生成模型。 |
prompt | string | 无 | - | 图像生成提示词。 |
n | integer | 1 | [1, 128] | 生成图片数量。数量越多消耗越高。 |
size | string | 模型默认 | - | 输出尺寸。具体可选值取决于模型。 |
quality | string | auto | - | 图像质量档位。具体值取决于模型。 |
response_format | string | 模型默认 | url / b64_json | 图片返回格式。 |
background | string / object | 模型默认 | transparent / opaque / auto | 背景配置。 |
output_format | string | 模型默认 | png / jpeg / webp | 输出图片格式。 |
output_compression | integer | 模型默认 | [0, 100] | 压缩质量。通常仅部分格式支持。 |
stream | boolean | false | true / false | 是否流式返回图像生成进度或部分图。 |
metadata / 额外字段 | object | 无 | - | 用于透传供应商特定参数。 |
音频参数
| 参数 | 类型 | 默认 | 取值范围 | 含义 |
|---|---|---|---|---|
model | string | 无 | - | 要调用的语音模型。 |
input | string | 无 | - | TTS 或音频任务输入。 |
voice | string | 模型默认 | - | 语音音色。取决于模型支持。 |
instructions | string | 无 | - | 语音生成指令。 |
response_format | string | 模型默认 | mp3 / wav / json | 响应格式。 |
speed | number | 1 | [0.25, 4] | 语速。取决于模型支持。 |
stream_format | string | 无 | sse | 流式音频返回格式。 |
metadata | object | 无 | - | 业务追踪或供应商扩展字段。 |
隐私相关字段
| 参数 | 类型 | 默认 | 平台处理 | 含义 |
|---|---|---|---|---|
store | boolean | 上游默认 | 默认允许透传，可按通道配置禁用 | 控制上游是否存储请求或输出。 |
safety_identifier | string | 无 | 默认过滤，除非通道明确允许 | 上游安全风控用户标识。涉及用户隐私，谨慎使用。 |
stream_options.include_obfuscation | boolean | 上游默认 | 默认过滤，除非通道明确允许 | 控制流式响应混淆行为。 |
metadata | object | 无 | 可能被记录或透传 | 自定义业务元数据，不要放密钥、密码或个人敏感信息。 |
参数使用建议
- 第一次调用只传
model、messages或input，确认模型可用后再增加参数。 - 不确定时只调一个采样参数，优先调整
temperature。 - 成本敏感场景设置
max_tokens或max_output_tokens。 - 使用工具调用时，先用简单 schema 测通，再增加复杂字段。
- 不要把 API 密钥、数据库连接串、身份证号等敏感信息放入
metadata或提示词。