开始使用
模型与错误处理
先用模型列表确认权限，再根据状态码定位问题。
获取模型列表
curl https://panel.weekendapi.site/v1/models \
-H "Authorization: Bearer $WEEKENDAPI_KEY"返回的模型 ID 才是当前分组可用值。模型名称、订阅权限和上游渠道会发生变化，不要把别人的示例模型写死到客户端。
常见状态码
| 状态 | 处理 |
|---|---|
| 401 | 检查密钥完整性、停用状态和认证头格式。 |
| 403 | 检查账户、分组或模型权限。 |
| 404 | 检查路径和 Base URL，避免重复 /v1。 |
| 400 | 先移除非必要字段，确认协议与请求体匹配。 |
| 429 | 降低并发并等待重试，检查客户端是否自动重试。 |
| 5xx | 保留请求 ID、时间和脱敏请求信息，联系管理员；不要重复提交付费或有副作用的请求。 |
安全边界
API 密钥只放在服务端环境变量或受保护的客户端配置中。不要将密钥、完整请求体、用户数据或支付信息贴到工单和截图。