Ramp 是财务自动化平台，提供 AI 用量追踪功能帮助企业管理 LLM 支出。通过 OpenRouter Broadcast，每次 LLM 请求的 token 用量、费用、模型信息和自定义元数据都会通过 OTLP 协议实时发送到 Ramp，在 AI Spend 仪表盘中可视化组织整体的 AI 成本。配置步骤：在 Ramp Settings > Integrations 搜索 OpenRouter 并生成 API Key，然后在 OpenRouter Broadcast 设置中填入该 Key 即可。

Ramp 是财务自动化平台，帮助企业管理费用和优化成本。通过 OpenRouter Broadcast，可以将 LLM 用量数据实时同步到 Ramp 的 AI 支出追踪功能。

配置步骤

第一步：获取 Ramp API Key

1. 登录 Ramp 账号
2. 进入 Settings > Integrations，搜索 "OpenRouter"
3. 点击 OpenRouter 集成查看详情，再点击 Connect
4. 点击 Generate API Key 并复制 token

第二步：在 OpenRouter 开启 Broadcast

前往 Settings > Observability，打开 Enable Broadcast 开关。

第三步：配置 Ramp

点击 Ramp 旁边的编辑图标，填写：

字段	填写内容
API Key	上一步从 Ramp 生成的 API Key
Base URL（可选）	默认 https://api.ramp.com/developer/v1/ai-usage/openrouter，仅在 Ramp 指引时才修改
Headers（可选）	自定义 HTTP Header（JSON 对象格式）

第四步：测试并保存

点击 Test Connection 验证配置，测试通过后自动保存。

第五步：查看 AI 支出数据

通过 OpenRouter 发送 API 请求，在 Ramp 的 AI Spend 仪表盘中验证数据已同步。

Trace 数据内容

Ramp 通过 OTLP 协议接收 trace，每条 trace 包含：

• Token 用量：prompt tokens、completion tokens、总计
• 费用信息：请求总费用
• 时间指标：开始时间、结束时间、延迟
• 模型信息：model slug 和 provider 名称
• 请求/响应内容（除非开启 Privacy Mode）

元数据映射

通过 trace 字段传入的自定义元数据以 span attributes 形式随 OTLP payload 发送：

键	OTLP 映射	说明
trace_id	Trace ID	将多个请求归入同一 trace
trace_name	Span Name	根 span 的自定义名称
span_name	Span Name	中间 span 的名称
generation_name	Span Name	LLM 生成 span 的名称
parent_span_id	Parent Span ID	链接到已有 span

字段映射说明：

• user 映射到 span attributes 中的 user.id
• session_id 映射到 session.id
• trace 中的自定义键以 trace.metadata.* 命名空间存储

示例

{
  "model": "openai/gpt-4o",
  "messages": [{ "role": "user", "content": "Analyze this expense report..." }],
  "user": "user_12345",
  "session_id": "session_abc",
  "trace": {
    "trace_id": "expense_analysis_001",
    "trace_name": "Expense Processing Pipeline",
    "generation_name": "Analyze Report",
    "department": "finance",
    "cost_center": "CC-1234"
  }
}

Privacy Mode

当为此目的地开启 Privacy Mode 时，prompt 和 completion 内容会从 trace 中排除。其他 trace 数据（token 用量、费用、时间、模型信息）仍正常发送。

常见问题

Q: Ramp 集成主要适合什么场景？

A: 主要适合企业财务团队和工程团队协作管理 AI 成本的场景。工程团队通过 OpenRouter 使用 LLM，财务团队在 Ramp 中看到 AI 支出的详细分类（按部门、成本中心、模型类型），从而做出更好的预算和采购决策。

Q: 是否支持按部门或项目分类 AI 费用？

A: 可以通过 trace 字段中的自定义元数据（如 department、cost_center、project）对 AI 请求打标签，Ramp 可以利用这些属性进行费用分类和归因。

Q: 如果我不想将对话内容发送到 Ramp，应该怎么做？

A: 开启 Privacy Mode 即可。这样 token 用量和费用等成本数据仍会发送用于财务追踪，但 prompt 和 completion 内容不会传输到 Ramp。