Appearance
Droid CLI
Droid CLI 类工具通常通过环境变量或配置文件接入 OpenAI 兼容 API。
统一接入信息
- 平台名称：FreeDom API
- 控制台 / API Base URL：
https://api.yonghu.shop - 鉴权方式：API Key
- API Key 获取：登录控制台 → 令牌 / API Key 页面创建
一、适用场景
- 想把 Droid CLI 的模型请求接到 FreeDom API
- 已经有平台 API Key
- 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型
二、安装 / 准备
安装 Droid CLI 后，先查看其帮助：
bash
droid --help确认是否支持 API Key、Base URL、Model 参数。
三、配置接入
推荐环境变量：
bash
export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"若 CLI 参数支持：
bash
droid --base-url "https://api.yonghu.shop" --api-key "你的_API_Key"四、启动验证
运行最小命令，确认能返回文本结果。
五、推荐模型填写方式
优先使用控制台里真实展示的模型名。常见可尝试：
- 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
请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。
七、实用建议
CLI 工具最容易出现环境变量没生效的问题。修改后请重新打开终端或 echo $OPENAI_BASE_URL 检查。
配置前检查
配置客户端前，先确认平台在线：
bash
curl https://api.yonghu.shop/api/status看到 success: true 或 HTTP 200，说明平台主入口正常。
如果客户端配置失败，优先按这个顺序排查：
- API Key 是否复制完整，没有多余空格。
- Base URL 是否该带
/v1。 - 模型名是否与平台模型广场完全一致。
- 当前 API Key 是否有该模型权限。
- 余额是否充足。
成功后建议到 FreeDom API 控制台查看日志，确认请求确实打到了平台。
Droid CLI 成功判据
Droid CLI 属于命令行客户端，优先用环境变量方式配置：
bash
export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"如果报 endpoint 不存在，改试：
bash
export OPENAI_BASE_URL="https://api.yonghu.shop/v1"成功判据：终端能返回模型回复，控制台日志能看到同一时间的请求。