Skip to content

Qwen Code ​

Qwen Code 若支持 OpenAI 兼容接口,可以接入 FreeDom API 使用平台开放的通用模型。

统一接入信息

  • 平台名称:FreeDom API
  • 控制台 / API Base URL:https://api.yonghu.shop
  • 鉴权方式:API Key
  • API Key 获取:登录控制台 → 令牌 / API Key 页面创建

一、适用场景 ​

  • 想把 Qwen Code 的模型请求接到 FreeDom API
  • 已经有平台 API Key
  • 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备 ​

安装 Qwen Code 对应 CLI 或插件,确认它支持自定义 API Base URL。

三、配置接入 ​

常见环境变量方式:

bash
export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

如果配置项叫 base_url、api_base 或 endpoint,都填:https://api.yonghu.shop。

四、启动验证 ​

执行一次简单生成任务,例如让它生成一个 hello world。

五、推荐模型填写方式 ​

优先使用控制台里真实展示的模型名。常见可尝试:

  • Claude:claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
  • Gemini:gemini-2.5-pro、gemini-2.5-flash
  • OpenAI 兼容工具:按平台模型广场/控制台展示为准

六、常见问题 ​

401 Unauthorized ​

API Key 错误、没保存成功,或请求头没有带上密钥。

403 Forbidden ​

通常是余额不足、Key 没有权限、模型未开放,或服务返回拒绝。

404 Model Not Found ​

模型名写错,或者当前 Key 没有这个模型权限。

429 Too Many Requests ​

请求过快或服务繁忙。降低并发、稍后重试,或切换模型或稍后重试。

七、实用建议 ​

如果工具默认强制使用 Qwen 官方模型名,而平台没有同名模型,需要在配置里手动改成平台已开放模型。

Qwen Code 成熟资料归纳 ​

Qwen Code 官方资料与 GitHub 讨论中都强调:API Key、模型参数、Base URL 要按实际服务端能力配置。接入 FreeDom API 时,按 OpenAI 兼容服务处理。

推荐环境变量:

bash
export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

如果工具要求完整 OpenAI endpoint,再改为:

bash
export OPENAI_BASE_URL="https://api.yonghu.shop/v1"

常见问题:

  • 模型名不存在:使用平台模型名,不要照搬 Qwen 官方模型名。
  • Key 无效:检查是否把 FreeDom API Key 填到了 OPENAI_API_KEY。
  • 路径错误:在 https://api.yonghu.shop 与 https://api.yonghu.shop/v1 间切换测试。

更多依据见:参考资料。

FreeDom API - 稳定、灵活、高性价比的 AI API 中转平台