用途：在开始新的 OpenRouter 集成或审查现有代码时，主动对照这份清单排查常见错误。内容来自生产事故与支持请求，而非理论推测。
主要能力：列出 10 个坑位及修复方式——模型 ID 必须用 provider/model 格式（如 openai/gpt-4o），否则返回 400 model not found；每次请求都要设置 max_tokens 以控制成本；模型 ID 集中到 MODELS 配置并在启动时对照 /api/v1/models 校验，避免上游改名导致失效；敏感数据请求用 provider.order 固定供应商并设 allow_fallbacks: False；生产环境不要用 :free 模型（每日 50-1000 次限制会触发 429）；每次调用记录 response.model 以发现意外回退；复用单个客户端实例以利用连接池；密钥放环境变量或密钥管理器，不要硬编码 sk-or-v1- 字符串；设置 timeout 与 max_retries；只缓存 temperature=0 的确定性响应。
使用方式：按清单逐项审计代码，用 grep 查找硬编码密钥与散落的模型 ID，运行启动校验片段，最后走一遍 PITFALL_CHECKLIST 作为代码审查产物。
前提：已有或正在进行的 OpenRouter 集成、OPENROUTER_API_KEY 环境变量、Python 3.8+ 与 OpenAI SDK。
限制：资料未提供具体价格、平台支持范围或效果保证；示例中的费用数字仅为说明性估算。