TradingAgents-CN 接入兼容模型 API

适合谁，以及为什么证据仍是 source-reviewed

中文界面下的多 Agent 股票研究与报告生成，适合需要中文报告和多市场入口的个人研究者。锁定版本的 .env.example 明确提供 ONEAPI_API_KEY 与 ONEAPI_BASE_URL，并说明模型通常不需要 provider 前缀。 当前没有从 TradingAgents-CN 自身运行路径获得非空模型回复，所以只能证明配置入口存在，不能写成已经接入成功。发布前应重跑项目 preflight、保存错误，并确认界面保存的模型字段与运行 worker 读取一致。

官方中文报告截图能证明界面，不证明数据链

截图来自仓库根目录 Apache-2.0 资产。仓库的 `app/` 与 `frontend/` 使用单独专有许可证，因此本站不复制其界面实现。中文报告是否可靠仍取决于行情、公告、新闻和模型工具调用。

通用 One API 入口位于模型层

TradingAgents-CN 把通用兼容服务作为一个 provider；模型请求通过 Base URL 和 Key 转发。A 股、港股、美股数据来自其他 provider，不能把模型接通误认为所有市场数据可用。

第一步：填写锁定版本公开的环境变量

复制 `.env.example` 后只改目标字段。不要把 Key 写进截图、Issue 或前端公开变量；Base URL 只到 `/v1`。

ONEAPI_API_KEY=sk-your-key
ONEAPI_BASE_URL=https://api.kkaiapi.com/v1

# 数据、结果和缓存目录仍按项目配置：
TRADINGAGENTS_RESULTS_DIR=./results
TRADINGAGENTS_DATA_DIR=./data
TRADINGAGENTS_CACHE_DIR=./cache

第二步：先做端点预检，不把预检当项目验证

以下请求只证明 Key、Base URL 和模型 ID 能通过兼容接口回复。预检成功后，仍要从 TradingAgents-CN 的正式运行入口完成同一模型调用，才可把状态升级为 verified。

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $ONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型页复制模型ID",
    "messages": [{"role": "user", "content": "只回复 ok"}]
  }'

中文、市场和许可证是三条独立判断

中文界面、A 股数据和代码许可分别决定可用性、研究范围和发布方式。任何一条成立，都不能替代另外两条的核验。

A 股数据验收比模型选择更优先

中文行情、公告、新闻和搜索数据源。至少检查公告日而不是报告期、复权规则、停牌与涨跌停、历史成分股、退市样本、新闻发布时间。选择一个历史日期复跑，确保系统不会读取未来发布的信息。 若报告引用无法打开、数字无法回到数据结果或工具失败后仍生成完整结论，应视为任务失败，而不是模型能力问题。

成本与常见故障

一次任务成本 = 输入 token × 输入单价 + 输出 token × 输出单价 + 缓存读写费用 + 外部数据费用。模型价格和实际 token 只从当前模型目录与控制台调用日志读取，不在文章里复制一份会过时的数字。 401 通常是 Key；404 先检查 /v1 与模型 ID；模型预检成功但项目失败，重点检查 provider 名称、界面保存值、后端读取和 endpoint 拼接；报告有内容但数据为空，要检查数据工具而不是反复换模型。

常见问题