主题
模型选择
调 API 第一件事就是选 model 参数。本页帮你在 why01 实际可用的模型清单里挑对那一个。
📋 唯一可信的模型清单 = 控制台模型页
TIP
所有可用模型 + 实时单价全部以 https://s1.why01.top/pricing 实际显示为准。本文档不会列具体模型名——上游模型每周都在变（新增、改名、下线），文档写死会很快过期。
操作步骤：
- 登录控制台 → 顶部菜单「模型」/「定价」
- 按「所属分组」筛选成你账户实际所在的分组
- 看到的列表 = 你当前 Key 能调用的全部模型，单价已经按你所在用户组算完
🎯 模型名必须精确匹配
API 调用里 model 字段是字符串，不容错、不模糊匹配：
| 写法 | 结果 |
|---|---|
gpt-5 | ✅（如果该名在你分组内） |
gpt4o | ❌ 404 model not found |
GPT-5 | ❌ 大小写敏感 |
gpt-5-mini-2025-08-07 | ✅ 带版本后缀也可（按控制台实际名） |
gpt5-pro-ultra-max（你瞎编的） | ❌ 即使逻辑上合理，没有就是没有 |
永远从控制台复制模型名，不要手敲，不要按"我以为这个名字应该这样"创造。
🧭 怎么挑模型
按用途倒推，不要从模型名表头硬挑。
按场景常见组合
| 场景 | 推荐档位 | 备注 |
|---|---|---|
| 日常对话、快速翻译、简单总结 | mini / haiku / flash 系列 | 便宜、够快 |
| 写代码、agent 工作流、复杂推理 | sonnet / gpt-5 / 4.x 系列 | 综合最稳 |
| 长上下文（一次喂大文件） | claude sonnet / gemini pro 长上下文版 | 看实际 context window |
| 图像理解 | 带 "vision" / multimodal 标签的版本 | 详见控制台标注 |
| 文生图 / 图生图 | imagen / dall-e / nano-banana 等 | 走 /v1/images/generations，不是 chat |
| 实时语音 / Realtime | 本站不保证——上游 Realtime API 大多走独家 endpoint | 强需求请用官方账号 |
三步选模型法
- 能力够用就行——先试便宜模型（mini / haiku），跑通了再考虑要不要升
- 看 context window——你的 prompt 比模型上下文窗口大就报错；先看模型支持多少 token
- 看价格再做最终决定——同等能力档位选最便宜那个
🔍 "model not found" 怎么办
按这个顺序排：
- 拼写——和控制台模型页的字符串字面比对，前后空格、大小写、连字符 / 下划线
- 分组——你的账户分组里没有这个模型？切到正确分组的页面看
- 令牌权限——修改令牌设置 里"可访问模型"勾了具体名单且没勾这个？要么加上、要么换 Key
- 下线——上游某些老模型（如
text-davinci-003）已停服，本站也调不了；换新版
🚫 "no permission" / 403 怎么办
你的账户所在分组没有这个模型的访问权——例如某些 Claude Opus / GPT-5 顶配模型只对 VIP 分组开放。两种处理：
- 换一个你能用的同档模型
- 想升分组 → 控制台「个人中心」看升级条件，或 联系客服
🏷️ 同名模型为什么有多个价格
控制台同一个模型名可能显示多档价格——对应不同上游渠道（官方 / 二级 / 廉价档）。详细解释见 价格说明 § 为什么同一个模型有多个价格档。
实操建议：开发测试随便选；生产业务优先稳定档——便宜档间歇不可用导致的失败成本可能远超差价。
📚 常见模型命名套路
不同厂商的模型名结构不同，记住几个套路就能秒读懂：
| 厂商 | 命名规则 | 例子（仅说明结构，请以控制台实际名为准） |
|---|---|---|
| OpenAI | <系列>-<容量>-<版本日期> | gpt-5-2025-08-07、gpt-5-mini、o1-preview |
| Anthropic | claude-<主版本>-<容量>-<日期> | claude-sonnet-4-6、claude-haiku-4-5 |
gemini-<版本>-<容量> | gemini-2.5-flash、gemini-2.5-pro |
容量档位通用规律：mini / haiku / flash < sonnet / regular < opus / pro / ultra——越大越贵越聪明（绝大多数情况下）。
⛔ 不要做的事
- ❌ 不要手编模型名——上游没有该名就是 404，编不出来。"我觉得 GPT-5 应该叫 gpt-5-turbo-pro" 这种没用
- ❌ 不要用别名假设——本站不会自动把
gpt-4映射成最新gpt-5，你写啥就调啥 - ❌ 不要在 prompt 里要求模型用别的模型回答——你能调用的模型由
model参数决定，prompt 里写"请用 GPT-5 回答"完全没用