通用参数
不同协议的字段不完全相同,但大多数文本接口都会围绕模型、输入、生成控制和输出格式展开。
核心字段
| 参数 | 常见位置 | 说明 |
|---|---|---|
model | 请求体 | 要调用的模型 ID,例如 gpt-4o、claude-sonnet-4-6、gemini-2.5-flash |
messages | /v1/chat/completions | 多轮对话消息数组 |
input | /v1/responses | Responses API 的输入内容 |
max_tokens / max_output_tokens | 请求体 | 控制最大输出长度,不同协议字段名不同 |
stream | 请求体 | 是否启用流式输出 |
temperature | 请求体 | 控制随机性,值越低越稳定 |
top_p | 请求体 | 核采样参数,通常不要和 temperature 同时大幅调整 |
tools | 请求体 | 工具或函数调用定义 |
response_format / text | 请求体 | 控制 JSON 或结构化输出 |
推荐调参顺序
- 先只传必填字段,确认接口、Key 和模型可用。
- 再调整
max_tokens或max_output_tokens,控制输出长度。 - 需要更稳定结果时降低
temperature,需要更多变化时提高temperature。 - 需要工具调用或结构化输出时,再加入
tools、tool_choice、response_format等高级字段。
模型选择
模型列表和能力建议集中放在 模型与能力。API 参考页只展示接口字段,不再承载模型选型说明。