Parameters / Model Families

模型参数

本页只解释常见重要参数和不同厂商/系列的差异，不维护固定模型清单。实际可用模型、上下文长度、输出上限、图片尺寸、音频格式和计费规则以控制台和上游官方文档为准。

通用文本参数

大多数 OpenAI 兼容文本模型都支持以下参数，但范围、默认值和是否生效会因上游而不同。遇到 400 错误时，先删除非必要采样参数，只保留 model、messages 和输出长度限制。

参数	作用	常见注意点
`temperature`	控制生成随机性和创造性。	低值更稳定，高值更发散；建议不要和 `top_p` 同时大幅调整。
`top_p`	核采样，限制候选 token 的累计概率范围。	适合需要更细地控制候选范围的场景；很多厂商建议与 `temperature` 二选一。
`top_k`	限制每步可选 token 数量。	并非所有 OpenAI 兼容模型都支持；部分模型会忽略或报错。
`max_tokens`	限制可见输出或总输出长度。	推理模型可能把思考 token 也计入输出预算，过小会导致截断。
`stop`	遇到指定字符串时停止生成。	适合模板化生成；不要把常见换行或标点误设为停止符。
`presence_penalty`	降低重复已出现内容的概率。	适合鼓励新主题；不是所有上游都支持。
`frequency_penalty`	按出现频率降低重复 token 概率。	适合减少机械重复；对事实类任务不宜过高。
`response_format`	约束输出为文本或 JSON。	即使设置 JSON，也要在提示词中明确字段和格式。
`stream`	是否通过 SSE 分片返回。	长输出建议开启；排障时建议先关闭。
`tools`	声明函数调用工具。	模型和上游需要同时支持，工具参数 JSON 需严格校验。

OpenAI / GPT / 推理系列

OpenAI 兼容文本模型通常支持 temperature、top_p、max_tokens、response_format、tools、stream 等参数。推理系列还会引入 reasoning.effort 或类似参数，用于在速度、成本和推理深度之间取舍。

参数	用途	建议
`reasoning.effort`	控制推理深度。	简单问答用低档，代码、规划、复杂分析用高档；可用值随模型变化。
`max_tokens` / `max_output_tokens`	限制输出预算。	不同 API 面使用的字段名不同；接入前确认客户端走 Chat Completions 还是 Responses。
`response_format`	结构化输出。	JSON 任务要同时写清楚 schema、字段含义和异常处理。

官方参考：OpenAI Reasoning models、OpenAI API Reference。

Anthropic / Claude 系列

Claude 兼容接口通常使用 /v1/messages。常见字段包括 system、messages、max_tokens、stop_sequences、tools 和 tool_choice。较新的 Claude 系列对采样和思考参数有更严格限制。

参数	用途	差异点
`max_tokens`	控制输出上限。	Messages 请求通常需要显式设置。
`system`	顶层系统指令。	不要把所有系统规则塞进最后一条用户消息。
`temperature` / `top_p` / `top_k`	采样控制。	部分新系列对非默认采样参数会返回 400；不确定时先省略。
`thinking` / `output_config.effort`	控制自适应思考或努力程度。	不同代际差异很大，迁移模型时必须核对官方迁移说明。

官方参考：Anthropic Messages API、Claude migration guide。

Google / Gemini 系列

Gemini 原生接口使用 contents 和 generationConfig，通过 OpenAI 兼容层接入时字段会被映射。多模态输入支持文本、图片、音频、视频和文件，但具体能力取决于模型。

参数	用途	差异点
`generationConfig.temperature`	控制随机性。	OpenAI 兼容层通常映射为顶层 `temperature`。
`generationConfig.topP` / `topK`	核采样和候选数量控制。	是否允许 `topK` 由模型决定。
`generationConfig.maxOutputTokens`	输出 token 上限。	OpenAI 兼容层常映射为 `max_tokens`。
`responseMimeType`	控制响应 MIME 类型。	JSON 或特定结构输出时要同时配合提示词。

官方参考：Gemini GenerateContent API、Gemini TTS generation。

DeepSeek 系列

DeepSeek 的聊天接口接近 OpenAI Chat Completions，但推理模式和非推理模式参数差异明显。部分推理模式会忽略或不支持 temperature、top_p、presence_penalty、frequency_penalty 这类采样参数。

参数	用途	建议
`thinking`	开启或关闭思考模式。	只在支持该字段的模型上使用。
`reasoning_effort`	控制推理努力程度。	具体可用值由上游定义；不支持时会报错或被映射。
`response_format`	JSON 输出。	使用 `json_object` 时，提示词中也必须明确要求 JSON。
`stream_options.include_usage`	流式返回中包含 usage。	只在 `stream: true` 时设置。

官方参考：DeepSeek Chat Completion、DeepSeek Thinking Mode。

Qwen / DashScope 系列

Qwen 在 DashScope / Model Studio 中提供 OpenAI 兼容接口。常见文本参数包括 top_p、temperature、presence_penalty、n、max_tokens、seed 和 stream。部分参数只在特定商业或开源系列中支持。

参数	用途	差异点
`seed`	控制随机种子。	便于回归测试，但不能保证所有模型完全复现。
`n`	返回多个候选结果。	会增加输出消耗；部分模型或工具调用场景固定为 1。
`presence_penalty`	减少重复。	部分模型系列才支持。
`enable_thinking`	控制部分思考模型是否启用思考。	仅在支持思考模式的系列上使用。

官方参考：Qwen OpenAI-compatible API。

图片生成参数

图片生成模型的参数差异比文本模型更大。OpenAI 图像接口常见参数包括 prompt、size、quality、n、output_format、response_format。Stable Diffusion / Stability、FLUX、Qwen-Image、Wan 等系列还常见 aspect_ratio、negative_prompt、seed、prompt_extend、watermark。

参数	常见厂商/系列	说明
`prompt`	所有图片生成系列	正向提示词，描述主体、构图、风格、文字、光照和限制。
`negative_prompt`	Stable Diffusion、Qwen/Wan 等	负向提示词，描述不要出现的元素；OpenAI 图像接口通常不用这个字段。
`size`	OpenAI、Qwen/Wan 等	可能是 `1024x1024`、`1280*1280` 或其他格式，必须按上游要求填写。
`aspect_ratio`	Stability、FLUX 等	用 `1:1`、`16:9`、`9:16` 这类比例控制画幅。
`quality`	OpenAI 图像系列	控制质量档位；不同模型可用枚举不同。
`seed`	Qwen/Wan、FLUX、Stable Diffusion 等	用于近似复现；图像生成仍有概率性。
`output_format`	OpenAI、Stability、FLUX 等	常见为 `png`、`jpeg`、`webp`。
`prompt_extend`	Qwen/Wan 等	是否让模型自动扩写提示词，适合用户提示较短的场景。

官方参考：OpenAI Image generation、OpenAI Create image reference、Stability AI API、Black Forest Labs FLUX API、Qwen-Image API、Wan text-to-image API。

音频生成参数

音频生成主要分为文本转语音、语音转语音和实时语音。文本转语音常见参数包括 input 或 text、voice、speed、volume、pitch、response_format、sample_rate、bitrate、stream_format。不同厂商命名差异明显。

参数	常见厂商/系列	说明
`voice` / `voice_id`	OpenAI TTS、MiniMax、CosyVoice、ElevenLabs	音色标识。克隆音色或设计音色通常需要先创建，再在合成请求中引用。
`speed`	OpenAI TTS、MiniMax、CosyVoice 等	语速。范围由厂商定义，过高会影响自然度。
`vol` / `volume`	MiniMax、CosyVoice 等	音量控制。OpenAI 标准 TTS 接口通常没有同名音量字段。
`pitch`	MiniMax、CosyVoice 等	音高控制，适合角色音色微调。
`response_format` / `format`	OpenAI TTS、MiniMax、CosyVoice 等	输出格式，常见为 `mp3`、`wav`、`pcm`、`opus`、`flac`。
`audio_sample_rate` / `sample_rate`	MiniMax、CosyVoice 等	采样率，决定音频清晰度、体积和兼容性。
`stream_format`	OpenAI TTS 等	控制流式返回格式；不是所有模型都支持 SSE。
`stability` / `similarity_boost`	ElevenLabs 类克隆音色	控制声音稳定性和与原始音色的相似度。

官方参考：OpenAI Create speech、MiniMax T2A guide、CosyVoice speech synthesis、ElevenLabs voice settings。

调参建议

目标	建议
稳定、可复现	降低 `temperature`，减少采样参数，固定提示词和输入；图像可尝试设置 `seed`。
更有创意	提高 `temperature` 或 `top_p`，但一次只改一个维度。
降低成本	降低 `max_tokens` 或推理 effort，精简上下文，图片降低尺寸或张数，音频降低采样率或时长。
降低延迟	开启 `stream`，减少输出长度，使用更快模型或低 effort；音频优先选择流式接口。
排查 400 错误	删除厂商特有参数，先用最小请求跑通，再逐个加回参数。