确认当前 Key 可用的模型
模型可见性取决于当前 API Key 和服务状态。应用启动、切换 Key 或模型不可用时，可使用模型列表接口确认应写入的模型 ID。
请求模型列表
curl https://1pkapi.com/v1/models \
-H "Authorization: Bearer $ONEPK_API_KEY"响应中的 data[].id 是可用于后续请求的模型 ID。请使用当前请求返回的值，不要复制其他账号、旧文章或聊天记录里的模型名称。
选择模型
- 先调用模型列表接口。
- 从返回的
data[].id中选择目标模型。 - 用短文本完成一次非流式调用。
- 验证成功后再启用流式、工具调用或较长上下文。
常见问题
| 现象 | 处理顺序 |
|---|---|
| 401 | 确认 Bearer 格式、环境变量和 Key 启用状态。 |
| 模型不在列表中 | 不要猜测模型 ID，以当前 Key 返回的列表为准。 |
| 429 或暂时异常 | 降低并发，避免连续高频重试，保留脱敏错误信息。 |
模型列表本身不等于永久承诺。正式任务发起前仍应处理 API 错误，并为用户提供明确的失败提示。