AI API Models List：先查可用模型，再开始接入测试
访问日志里 /v1/models 请求很多，说明开发者在接入前最关心“到底有哪些模型可用”。这个页面把模型发现、场景选择和下一步测试入口串起来，减少用户注册后不知道先点哪里的流失。
/v1/modelsmodel routingcoding modelRAG model
最小可验证步骤
先用低额度测试 Key 做一次真实请求，再决定是否接入生产服务。
curl https://api.clawskills.shop/v1/models \
-H "Authorization: Bearer YOUR_CLAWSKILLS_API_KEY"模型选择不要只看名字
- 代码场景优先看稳定性、工具调用/长上下文和输出格式。
- 中文内容、摘要、客服可以先用较低成本模型跑 AB 测试。
- RAG 项目要同时观察延迟、上下文长度、幻觉率和失败重试成本。
建议的第一轮测试
- 用相同 prompt 分别跑 2-3 个候选模型。
- 记录首 token 延迟、总耗时、错误率、单次成本和输出可用率。
- 把生产服务默认模型和备用模型分开配置，避免一个上游异常拖垮全站。
控制台里应该完成的动作
- 查看价格页和可用模型。
- 创建测试 Key 并设置预算。
- 在 Playground 复制最小调用代码。
- 把模型名写到服务端配置，不要硬编码在前端。
常见问题
/v1/models 返回为空怎么办？
先确认 Key 是否有效、账户是否有可用额度、请求 base_url 是否正确；仍异常时在控制台换一个可用模型或联系支持。
模型价格会固定不变吗？
不承诺固定。模型、价格和可用性可能随上游变化，以控制台实时显示为准。
能不能把模型列表暴露给前端？
不建议直接把真实 API Key 放进浏览器。前端需要展示模型时，应由自己的服务端代理并控制权限。
合规说明：ClawSkills 定位为开发者 OpenAI-compatible multi-model API gateway，不宣传号池、无限量、官方同源、全网最低价或任何收益保证；请遵守模型提供方、平台和当地法律政策。