---
title: "Ramp"
url: "/docs/observability/ramp_integration"
canonical_url: "https://docs.litellm.ai/docs/observability/ramp_integration"
type: "docs"
last_updated: "2026-10-08"
related:
  - "/docs/observability/pointfive"
  - "/docs/observability/vantage"
---
# Ramp

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


將 AI 使用量與成本資料傳送至 Ramp，以便自動追蹤支出。

[Ramp](https://ramp.com/) 是一個金融自動化平台，可協助企業管理支出、公司卡和供應商付款。透過 Ramp 回呼整合，您的 LiteLLM AI 使用情況（包含 token 數量、模型成本和請求中繼資料）會自動傳送至 Ramp，以便即時掌握支出可視性。

:::info
我們希望了解如何讓回呼做得更好！歡迎認識 LiteLLM [founders](https://calendly.com/d/4mp-gd3-k5k/berriai-1-1-onboarding-litellm-hosted-version) 或
加入我們的 [discord](https://discord.gg/wuPM9dRgDw)
:::

## 前置需求 {#pre-requisites}

1. 登入 [Ramp](https://app.ramp.com/)，並使用搜尋列搜尋 **"LiteLLM"**。點擊 **LiteLLM** 整合結果。

> **注意：** 只有業主與管理員可以存取並設定整合。

2. 在 LiteLLM 整合頁面右上角點擊 **Connect** 按鈕。

3. 在 Connect LiteLLM 抽屜中，點擊 **Generate API Key** 以建立 API 金鑰。

> **重要：** 請立即複製 API 金鑰，因為之後將不會再次顯示。如果遺失，您可以從整合設定中撤銷現有金鑰並產生新的金鑰。

```shell
pip install litellm
```

## 快速開始 {#quick-start}

設定您的 `RAMP_API_KEY`，並將 `"ramp"` 加入回呼，以開始將 LLM 使用量記錄至 Ramp。

**SDK**

```python
litellm.callbacks = ["ramp"]
```

```python
import litellm
import os

# Ramp API Key
os.environ["RAMP_API_KEY"] = "your-ramp-api-key"

# LLM API Keys
os.environ['OPENAI_API_KEY'] = ""

# Set ramp as a callback
litellm.callbacks = ["ramp"]

# OpenAI call
response = litellm.completion(
  model="gpt-5.6-luna",
  messages=[
    {"role": "user", "content": "Hi - I'm testing Ramp integration"}
  ]
)
```

**LiteLLM Proxy**

1. 設定 config.yaml

```yaml
model_list:
  - model_name: gpt-5.6-luna
    litellm_params:
      model: openai/gpt-5.6-luna
      api_key: os.environ/OPENAI_API_KEY

litellm_settings:
  callbacks: ["ramp"]

environment_variables:
  RAMP_API_KEY: os.environ/RAMP_API_KEY
```

2. 啟動 LiteLLM Proxy

```bash
litellm --config /path/to/config.yaml
```

3. 測試一下！

```bash
curl -L -X POST 'http://0.0.0.0:4000/chat/completions' \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $LITELLM_API_KEY" \
-d '{
  "model": "gpt-5.6-luna",
  "messages": [
    {
      "role": "user",
      "content": "Hey, how are you?"
    }
  ]
}'
```

## 記錄了哪些資料？ {#what-data-is-logged}

LiteLLM 會在成功的 LLM API 請求時，將 [Standard Logging Payload](https://docs.litellm.ai/docs/proxy/logging_spec) 傳送至 Ramp，其中包括：

- **請求詳細資料**：模型、訊息、參數
- **回應詳細資料**：完成文字、token 使用量、延遲
- **中繼資料**：使用者 ID、自訂中繼資料、時間戳記
- **成本追蹤**：根據 token 使用量計算的回應成本

## 驗證 {#authentication}

將 `RAMP_API_KEY` 環境變數設定為您的 Ramp API 金鑰。

| 環境變數 | 說明 |
|---|---|
| `RAMP_API_KEY` | 您的 Ramp API 金鑰（必填） |

## 支援與創辦人交流 {#support--talk-to-founders}

- [安排示範 👋](https://calendly.com/d/4mp-gd3-k5k/berriai-1-1-onboarding-litellm-hosted-version)
- [社群 Discord 💭](https://discord.gg/wuPM9dRgDw)
- 我們的電話 📞 +1 (770) 8783-106 / ‭+1 (412) 618-6238‬
- 我們的電子郵件 ✉️ ishaan@berri.ai / krrish@berri.ai

## Related pages

- [PointFive](https://docs.litellm.ai/docs/observability/pointfive.md)
- [Vantage](https://docs.litellm.ai/docs/observability/vantage.md)