使用单个 Bearer 密钥将 Vortixy Chat 集成到你的项目中。配额与你的套餐一致。 在仪表盘 → 你的 API 中创建密钥
所有错误均遵循 RFC 9457 并返回本地化消息。请检查 code 字段以进行编程处理。
{ "error": "You reached the daily quota. Try again after 2h.", "code": "quotaExceeded", "retryAfter": 7200, "resetsInSeconds": 7200, "resetsAt": "2026-09-27T00:00:00.000Z" }
// 429 de cuota diaria: countdown absoluto 00:00 UTC (resetsAt) + relativo
// (resetsInSeconds/Retry-After) + RateLimit-* headers — no derives el reset
// con tu reloj local| 状态 | 代码 | 何时出现 |
|---|---|---|
| 400 | validation | 无效 JSON 或字段超出范围 |
| 401 | apiKeyInvalid | 缺失或无效的 Bearer 密钥 |
| 403 | planRequired | 该模型在你的套餐中不允许 |
| 403 | byokMissing | 该提供商的 BYOK 密钥缺失 — 请在 Dashboard → 设置 → AI 密钥中保存 |
| 429 | quotaExceeded | 已达到每日 tokens / 请求 / 搜索上限 |
| 429 | rateLimited | 每分钟请求过多 — 请等待 Retry-After，然后用退避策略重试 |
| 503 | aiEngineUnavailable | 服务暂时不可用 — 请用退避策略重试，并检查 /api/health |
| 502 | aiEngineFailed | 上游模型错误 |
请求头： RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After, WWW-Authenticate on 401.
按月还是按年?
年付可节省 17%。