mirror of
https://git.openapi.site/https://github.com/desirecore/config-center.git
synced 2026-06-06 10:50:53 +08:00
xieyuanxiang
b0e0cead04
Batch update from official docs audit - price corrections, context window fixes, field report updates across all providers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
90 lines
5.0 KiB
Markdown
90 lines
5.0 KiB
Markdown
# 采样参数复核报告
|
||
|
||
- 复核范围: `defaultTemperature` / `defaultTopP`
|
||
- 复核时间: `2026-04-24`
|
||
- 复核对象: `compute/providers/*` 与 `compute/coding-plans/*`
|
||
|
||
## 判定规则
|
||
|
||
1. 官网明确写出 `Defaults to ...`，或官方接口示例在省略参数时返回固定值:
|
||
填写该数字，视为官方默认值。
|
||
2. 官网只给参数范围、推荐起点、示例值，或者说明“默认值随模型而变”但公共页面不公开具体数字:
|
||
JSON 不保留伪官方默认值，改为 `null`；如有意义，可在字段表里记“参考值”。
|
||
3. 模型类型不使用聊天采样参数，例如 `embedding`、`rerank`、`tts`、`image_generation`、大部分 `asr` / `video_generation`:
|
||
统一记为 `null`。
|
||
4. 聚合平台、自动路由别名、或本地别名无法和官网型号 1:1 映射:
|
||
不硬填，记为 `null`，并在对应 `未确认字段报告.md` 写明查过的网址和原因。
|
||
|
||
## 已确认为官方默认值
|
||
|
||
- `OpenAI`:
|
||
文本/视觉/Responses 模型保留 `temperature=1`、`top_p=1`。
|
||
依据: `https://platform.openai.com/docs/api-reference/chat/create-chat-completion`, `https://platform.openai.com/docs/api-reference/responses/retrieve`
|
||
- `Anthropic`:
|
||
`temperature=1`。
|
||
依据: `https://docs.anthropic.com/en/api/messages`
|
||
- `Google Gemini 3`:
|
||
`temperature=1`、`topP=0.95`。
|
||
依据: `https://ai.google.dev/gemini-api/docs/gemini-3`, `https://ai.google.dev/gemini-api/docs/prompting-strategies`, `https://ai.google.dev/api/models`
|
||
- `Cohere Chat`:
|
||
`temperature=0.3`、`topP=0.75`。
|
||
依据: `https://docs.cohere.com/reference/chat`
|
||
- `Mistral`:
|
||
`top_p=1`；`temperature` 公共文档未给固定数字。
|
||
依据: `https://docs.mistral.ai/api`
|
||
- `MiniMax` / `MiniMax Coding`:
|
||
主模型家族统一确认 `temperature=1`、`top_p=0.95`；`MiniMax-Text-01` 为 `0.1 / 0.95`。
|
||
依据: `https://platform.minimaxi.com/docs/api-reference/text-chat-openai`, `https://platform.minimaxi.com/docs/api-reference/text-post`
|
||
- `DashScope / Qwen`:
|
||
多数官方模型已按接口默认值确认，例如 `qwen3.5-plus` / `qwen3.6-*` 为 `0.6 / 0.95`，`qwen-max` 为 `0.7 / 0.8`。
|
||
依据: `https://help.aliyun.com/zh/model-studio/qwen-api-via-openai-chat-completions`, `https://help.aliyun.com/zh/model-studio/qwen-api-via-dashscope`
|
||
- `DeepSeek`:
|
||
`deepseek-chat = 1 / 1`。
|
||
依据: `https://api-docs.deepseek.com/api/create-chat-completion`
|
||
- `Moonshot / Kimi`:
|
||
`kimi-k2.5 = 1 / 0.95`，`kimi-k2 = 0.6 / 1`，`kimi-k2-thinking = 1 / 1`，`moonshot-v1-* = 0 / 1`。
|
||
依据: `https://platform.kimi.com/docs/api/models-overview`, `https://platform.kimi.com/docs/guide/kimi-k2-5-quickstart`, `https://platform.kimi.com/docs/guide/kimi-k2-quickstart`
|
||
- `Zhipu / Zhipu Coding`:
|
||
`glm-5*`、`glm-4.7*`、`glm-4.6*` 默认 `temperature=1`、`top_p=0.95`。
|
||
依据: `https://docs.bigmodel.cn/api-reference`
|
||
- `Baidu`:
|
||
`ernie-4.5-turbo-* = 0.8 / 1`。
|
||
依据: `https://cloud.baidu.com/doc/qianfan/s/6mh4stoyf`
|
||
- `Xunfei`:
|
||
`spark-x = 1.2 / 0.95`，`4.0Ultra = 1 / 1`。
|
||
依据: `https://www.xfyun.cn/doc/spark/X1http.html`, `https://www.xfyun.cn/doc/spark/HTTP%E8%B0%83%E7%94%A8%E6%96%87%E6%A1%A3.html`
|
||
- `OpenRouter`:
|
||
平台级默认 `temperature=1`、`top_p=1`。
|
||
依据: `https://openrouter.ai/docs/api/reference/parameters`
|
||
- `Ollama`:
|
||
`llama3.1:70b = 0.8 / 0.9`。
|
||
依据: `https://docs.ollama.com/modelfile`
|
||
- `Kwai Coding`:
|
||
`kwai-coder = 1 / 1`。
|
||
依据: `https://www.streamlake.com/document/WANQING/me6z3u08sjus2mzplbj`
|
||
|
||
## 已改为 null 的类型
|
||
|
||
- 官网没有公开默认值:
|
||
`Perplexity`, `xAI`, `Tencent Hunyuan`, `Lingyiwanwu`, `Baichuan` 本地 `M2/M3` 系列。
|
||
- 官网明确参数不适用:
|
||
`DeepSeek Reasoner`, `BGE / Embed / Rerank`, `Kling` 视频模型, `Stability` 图像模型, `Zhipu embedding`, 多数 `TTS / ASR / image / video` 模型。
|
||
- 官网只给“随模型而变”但公共页没有具体数值:
|
||
`Mistral temperature`, `Google Gemini 2.5 temperature`。
|
||
- 本地别名无法和官网型号一一映射:
|
||
`infini-coding/deepseek-v3`, `moonshot-coding/kimi-for-coding`, `volcengine-coding/ark-code-latest`, `dashscope/qwen3-max-trans`。
|
||
|
||
## 参考值但不写入 JSON 的边界项
|
||
|
||
- `Google Gemini 2.5 temperature`:
|
||
官方 `models.get` 文档承认存在 backend 默认值，但公共文档未直接公开数字；本地旧值 `1.0` 只能视为参考，JSON 保持 `null`。
|
||
- `DashScope qwen3-max-trans`:
|
||
机器翻译文档里有 `qwen-mt` 的采样默认值，但本地别名没有官方 1:1 映射，JSON 保持 `null`。
|
||
|
||
## 结果说明
|
||
|
||
- 这轮复核后，仓库里 `defaultTemperature` / `defaultTopP` 的取值不再沿用“习惯值”或“看起来像默认值”的数字。
|
||
- 能从官网坐实的，已经改成官方默认值。
|
||
- 官网不公开默认值或字段不适用的，已经明确改成 `null`。
|
||
- 仍出现在各 provider `未确认字段报告.md` 里的条目，不是没查，而是官网当前只给参数定义、范围、或要求调用 API 元数据接口才能取到具体默认值。
|