XQCOpenRouter 0.0.3

高效、易用的 OpenRouter API Python 客户端，支持同步与异步调用。

🚀 XQCOpenRouter

✨ XQC 是微信公众号：XiaoqiangClub 的简写

XQCOpenRouter 是一个高效、易用的 OpenRouter API Python 客户端，支持同步与异步调用方式，适合快速集成与二次开发。

---

🌟 功能亮点

• 🆓 自动 调用免费模型进行交互
• 🧱 支持主模型（primary_model）、备用模型（backup_models）、自动免费模型三重兜底
• 📂 支持文件导入提示词
• 🔄 同时支持同步（Sync）与异步（Async）调用
• 📋 一行代码获取免费大模型列表，轻松免费用大模型
• 🔧 动态修改提示词，灵活适配多场景
• 🛡️ 支持自动选择最新免费模型、自动降级等高级特性
• 🧩 代码结构清晰，易于扩展
• 📝 完善类型注解与中文文档

---

📒 说明文档 📒

• https://blog.csdn.net/xiaoqiangclub/article/details/148495167

---

💬 联系与支持

• 👨‍💻 作者：Xiaoqiang
• 📢 微信公众号：XiaoqiangClub
• 📧 反馈与建议请通过邮件联系：[e-mail]
• ☕ 请我喝咖啡支持项目发展：

---

⚡ 模型兜底与fallback逻辑说明

• chat方法会严格按顺序依次尝试：
  1. 主模型（primary_model）
  2. 所有备用模型（backup_models，顺序遍历，每个只尝试一次）
  3. 若全部失败，再依次尝试免费模型（自动获取，顺序遍历，尝试次数由fallback_max参数控制）
• 总尝试次数 = 1（主模型）+ N（备用模型数量）+ fallback_max（免费模型最大尝试次数）
• 只有全部失败时才会返回"请求失败"
• 相关参数：
  • fallback_max：控制免费模型最大尝试次数，实际生效值为"备用模型数量+fallback_max" ，即总共会尝试（主模型+所有备用模型+fallback_max个免费模型）
  • auto_fallback：是否启用免费模型兜底，默认True
  • auto_latest_free：当主模型和备用模型都未设置时，若为True则优先自动选择最新免费模型，否则选择任意免费模型

示例：

• backup_models=["bak1","bak2"], fallback_max=2，则最多尝试1（主）+2（备）+4（免费）=5次
• backup_models=[], fallback_max=3，则最多尝试1（主）+0（备）+3（免费）=4次