API 使用条款

本条款适用于通过 QiyuanHub OpenAI 兼容 API 进行调用的所有开发者与用户。

1. 接入方式

使用 HTTPS 请求 `https://api.qiyuanapi.cc/v1`，在 Header 中携带 `Authorization: Bearer <API_KEY>`。

2. 限流与配额

平台对单 Key 和用户维度实施 RPM 限流。单 Key 可设置独立配额上限。超出限制将返回 `rate_limited` 或 `quota_exceeded` 错误。

3. 错误码

常见错误及对应 HTTP 状态码：`unauthorized`(401)、`key_expired`(403)、 `application_pending`(403)、`model_unavailable`(404)、`model_not_allowed`(403)、 `model_not_multimodal`(400)、`ip_not_allowed`(403)、`quota_exceeded`(402)、 `rate_limited`(429)、`backend_unavailable`(503)。

请按状态码区分处理：402 表示余额或配额耗尽（需充值，不是密钥问题）； 404 表示模型名写错或该模型已下线，可调用 `/v1/models` 查询当前可用模型； 401 才是密钥本身无效。5xx 可安全重试，4xx 重试无意义。

4. 服务变更

平台有权调整模型上下线、定价与限流策略，重大变更将提前在控制台或文档中公告。

5. 禁止用途

禁止用于攻击、爬虫滥用、绕过计费、批量注册滥用及其他违反法律法规的用途。