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_urlapi_baseendpoint,都填:https://api.yonghu.shop

四、启动验证

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

五、推荐模型填写方式

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

  • Claude:claude-sonnet-4-5-20250929claude-opus-4-8claude-opus-4-8-thinking
  • Gemini:gemini-2.5-progemini-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.shophttps://api.yonghu.shop/v1 间切换测试。

更多依据见:参考资料

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