企业官网建设流程全解析

下面以最新 Chat Completions API（v1/2026）为核心，把所有参数按「必填→核心生成控制→采样→惩罚→格式 / 工具→高级 / 推理→流式→多模态→废弃」分组，逐条讲清作用、取值范围、默认值、典型用法与避坑。

（基于 OpenAI 官方文档 + 2026‑05 最新实践，含 gpt‑4o/4o‑mini/3.5‑turbo 通用参数）

一、必选参数（缺一不可）

1.model（字符串）

• 作用：指定模型版本
• 常用值：
  • gpt-4o（最新多模态，最强）
  • gpt-4o-mini（轻量、低成本、快）
  • gpt-4-turbo（长上下文 128k）
  • gpt-3.5-turbo（性价比之王）
• 示例："model": "gpt-4o"

2.messages（数组）

• 作用：对话历史 / 输入上下文
• 结构：每一条是{"role": "...", "content": "..."}
  • role：system（人设）、user（用户）、assistant（历史回复）
  • content：文本 / 多模态内容（图文混合）
• 示例：

json

"messages": [ {"role": "system", "content": "你是资深架构师"}, {"role": "user", "content": "解释一下混合AI"} ]

二、核心生成控制（最常用）

3.max_completion_tokens（整数，推荐）

• 作用：最大输出 token 数（含思考 + 可见输出）
• 范围：1～模型上限（如 gpt‑4o 128k）
• 默认：无上限（受模型总上下文限制）
• 替代旧参数：max_tokens（已逐步废弃）
• 场景：控长度、防超长、控成本
• 示例："max_completion_tokens": 1024

4.n（整数）

• 作用：生成n 个独立候选回复
• 范围：1～16
• 默认：1
• 计费：按所有 n 的总 token 计费
• 场景：多方案对比、创意发散
• 示例："n": 3

5.stream（布尔）

• 作用：流式输出（SSE），逐字返回
• 默认：false（一次性返回完整结果）
• 场景：聊天界面实时打字、降低感知延迟
• 配合：stream_options（见下文）
• 示例："stream": true

6.stop（字符串 / 数组）

• 作用：遇到指定停止符立即终止生成
• 示例："stop": ["\n\n", "###"]
• 场景：固定格式生成（如 JSON、Markdown 区块）

三、采样策略（控制 “创造性”，二选一即可）

7.temperature（浮点数）

• 作用：随机性 / 发散度
• 范围：0.0～2.0
• 默认：1.0
  • 0.0：最确定、最保守、重复度高（适合代码 / 数学）
  • 0.7：平衡（日常对话）
  • 1.5：最发散、创意、不稳定（写诗 / 故事）
• 最佳实践：temperature 与 top_p只调一个

8.top_p（浮点数，Nucleus Sampling）

• 作用：按概率累积采样，只从前 p% 概率的 token 里选
• 范围：0.0～1.0
• 默认：1.0（全概率）
• 示例：top_p=0.9→ 只从累计概率前 90% 的候选里选
• 特点：比 temperature 更 “智能”，保留高质量候选

9.top_k（整数，部分模型支持）

• 作用：只从概率最高的 k 个 token里选
• 范围：1～100
• 默认：无限制
• 场景：极端控发散（少用）

四、重复度惩罚（防啰嗦 / 重复）

10.presence_penalty（浮点数）

• 作用：惩罚出现过的 token（鼓励引入新话题）
• 范围：-2.0～2.0
• 默认：0
  • 正数：抑制重复、鼓励拓展
  • 负数：鼓励重复、保守
• 场景：长对话、避免循环

11.frequency_penalty（浮点数）

• 作用：按出现频率惩罚（抑制高频词重复）
• 范围：-2.0～2.0
• 默认：0
• 区别：presence = 是否出现过；frequency = 出现次数
• 场景：文案写作、避免用词单调

五、格式与工具调用（结构化输出 / 函数调用）

12.response_format（对象）

• 作用：强制输出格式（JSON / 文本）
• 类型：
  • {"type": "text"}（默认）
  • {"type": "json_object"}（强制合法 JSON）
• 示例：

json

"response_format": {"type": "json_object"}

• 场景：API 交互、结构化数据抽取

13.tools（数组）

• 作用：函数调用 / 工具能力（联网、代码、自定义工具）
• 结构：JSON Schema 描述工具
• 示例：

json

"tools": [ { "type": "function", "function": { "name": "search", "description": "联网搜索", "parameters": {"query": {"type": "string"}} } } ]

14.tool_choice（字符串 / 对象）

• 作用：强制 / 自动选择工具
• 可选："auto"（默认）、"none"、{"type":"function","function":{"name":"xxx"}}

六、高级 / 推理模型专属（gpt‑4o/5 系列）

15.reasoning_effort（字符串，推理模型专用）

• 作用：思考深度（控制推理算力）
• 可选：low/medium/high
• 默认：medium
• 场景：复杂数学、多步骤推理 →high；快答 →low

16.logprobs（整数）

• 作用：返回每个 token 的对数概率（用于置信度评估）
• 范围：0～20
• 示例："logprobs": 5→ 每个位置返回前 5 个候选概率

17.logit_bias（对象）

• 作用：手动干预 token 概率（强制出现 / 禁止某些词）
• 格式：{token_id: bias(-100~100)}
• 示例：禁止 “废话”：{"1234": -100}

18.store（布尔）

• 作用：是否存储本次对话（用于模型蒸馏 / 评估）
• 默认：false

19.metadata（对象）

• 作用：自定义标签，用于后台筛选 / 统计
• 示例：{"project": "hybrid-ai", "env": "prod"}

七、流式输出配套

20.stream_options（对象，stream=true 时有效）

json

"stream_options": { "include_usage": true, // 最后返回 token 用量 "include_obfuscation": false }

八、多模态参数（gpt‑4o 专属）

21.modalities（数组）

• 作用：生成文本 / 音频
• 示例：["text", "audio"]

22.audio（对象）

• 作用：音频输出参数（如语音人声音色）

九、废弃 / 旧参数（不要再用）

• max_tokens→ 替换为max_completion_tokens
• best_of→ 服务端多候选再选最优，与stream不兼容，废弃

十、常用参数组合（直接复制可用）

1）精准 / 代码 / 数学

json

{ "model": "gpt-4o", "temperature": 0.1, "top_p": 0.95, "max_completion_tokens": 2048, "frequency_penalty": 0.2 }

2）创意 / 文案 / 故事

json

{ "model": "gpt-4o", "temperature": 1.2, "top_p": 0.9, "presence_penalty": 0.5 }

3）结构化 JSON 输出

json

{ "model": "gpt-4o", "response_format": {"type": "json_object"}, "temperature": 0.3 }

十一、参数速查表（精简版）