Ingested cost_details without a pricing-table model match never populate effective cost – counted in aggregates but rendered as $0.00 in tab

问题场景

用户在 Langfuse Cloud v4 项目中使用 Python SDK 4.14.2 通过 OTel ingestion 写入观测数据，并直接传入 usage_details 和 cost_details，例如对非 LLM 的 API 调用（网页抓取、搜索服务）按次计费并记录到 tool 类型观测。同一个观测在不同 API 表面返回值不一致：公共 API 返回 costDetails 和 calculatedTotalCost，Metrics API 会计入 totalCost，但观测表格 / Trace 视图（TRPC generations.all）返回 costDetails: {} 和 totalCost: 0，最终渲染成 $0.00。

报错原文

Ingested cost_details without a pricing-table model match never populate effective cost - counted in aggregates but rendered as $0.00 in tab

原因分析

可能原因：文档声明直接摄入的 cost_details 会被“按原样使用（verbatim）”，但实际 ingestion 流程只将其放入 provided_cost_details / provided_usage_details字段；只有观测的 model 匹配到定价表定义时，系统才会计算并填充 effective cost_details。Issue 中的对照实验表明，同样内容只要加上匹配自定义 pricing table 的 model.name + usage_details，就能正确计算并渲染，说明 promotion 逻辑被“模型匹配”这一条件卡住了，而不是观测类型限制。

环境排查

• 确认 Langfuse 环境是否为 Cloud v4 project（us.cloud.langfuse.com）。
• 确认 Python SDK 版本是否为 4.14.2，并确认是否走 OTel ingestion。
• 确认观测对象写入时的 model 字段是否为空，或是否在自定义 pricing table 中有匹配定义。
• 确认观测类型：Issue 中在 generation 类型上复现，tool 类型也可能受影响，但注意 SDK 对 tool 类型可能丢弃 cost_details 参数。
• 对比同一观测的公共 API 响应和 TRPC generations.all 响应，检查 costDetails/providedCostDetails 字段。

解决步骤

1. 在 UI 或公共 API 中查看该观测，确认 ingestion 是否写入了 providedUsageDetails 和 providedCostDetails。
2. 如果 cost 确实已写入 provided 字段但 effective 字段为空，先检查该观测的 model 值；尝试在自定义 pricing table 中为这个 model.name 配置价格定义，并传入匹配的 usage_details。
3. 如果不希望依赖 pricing table，可等待官方修复 langf
   

   参考来源

   langfuse/langfuse #15696

   

   AI 工具推荐

   想把多个 AI 模型放在一个入口？

   GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

   了解 GamsGo AI

   推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

   这个方案解决了吗？

   解决了还没有