Levo
API 與 LLM 安全性測試和可觀測性,位於 levo.ai。
前置需求
uv add litellm
除了您的 API 金鑰之外,您還需要一個 Levo collector URL。若您沒有,請聯絡 Levo 支援。
快速開始
- SDK
- LiteLLM Proxy
import litellm
import os
os.environ["LITELLM_OTEL_V2"] = "true"
os.environ["LEVOAI_API_KEY"] = ""
os.environ["LEVOAI_ORG_ID"] = ""
os.environ["LEVOAI_WORKSPACE_ID"] = ""
os.environ["LEVOAI_COLLECTOR_URL"] = ""
# LLM API Keys
os.environ["OPENAI_API_KEY"] = ""
# set levo as a callback, litellm will send the data to levo
litellm.callbacks = ["levo"]
# openai call
response = litellm.completion(
model="gpt-5.6-terra",
messages=[
{"role": "user", "content": "Hi 👋 - i'm openai"}
]
)
- 設定 config.yaml
model_list:
- model_name: gpt-5.6-terra
litellm_params:
model: openai/gpt-5.6-terra
api_key: os.environ/OPENAI_API_KEY
litellm_settings:
callbacks: ["levo"]
- 設定您的憑證
LITELLM_OTEL_V2=true
LEVOAI_API_KEY="your-api-key"
LEVOAI_ORG_ID="your-org-id"
LEVOAI_WORKSPACE_ID="your-workspace-id"
LEVOAI_COLLECTOR_URL="your-levo-collector-url" # contact Levo support for this
- 啟動 LiteLLM Proxy
litellm --config /path/to/config.yaml
- 測試它!
curl -L -X POST 'http://0.0.0.0:4000/v1/chat/completions' \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $LITELLM_API_KEY" \
-d '{
"model": "gpt-5.6-terra",
"messages": [
{
"role": "user",
"content": "Hey, how are you?"
}
]
}'
Levo 會呈現什麼
打開 Levo 儀表板。Levo 不會新增供應商對應器,因此 span 會以 canonical gen_ai.* schema 抵達;完整鍵值清單請參閱 Span attributes。
預設會將 span 路由到 LEVOAI_COLLECTOR_URL,並使用 Authorization: Bearer $LEVOAI_API_KEY,以及從 LEVOAI_ORG_ID 和 LEVOAI_WORKSPACE_ID 建立的 x-levo-organization-id 和 x-levo-workspace-id 標頭。
組態
| 變數 | 必填 | 備註 |
|---|---|---|
LEVOAI_API_KEY | 是 | |
LEVOAI_ORG_ID | 是 | |
LEVOAI_WORKSPACE_ID | 是 | |
LEVOAI_COLLECTOR_URL | 是 | 原樣使用,不做路徑處理,因此請提供 Levo 給您的 دقیق確 URL |
這四項都會在啟動時驗證;若有任何一項缺少,整合會擲出例外。若要用環境標記 span,請設定 OTEL_ENVIRONMENT_NAME,這會在每個 span 上標記 deployment.environment。
OpenTelemetry 完整參考
此頁涵蓋 Levo 專屬設定。關於 span attributes、prompt 與 response 擷取、metrics、distributed tracing,以及哪些 routes 會被追蹤,請參閱 OpenTelemetry v2 guide。
支援與聯絡創辦人
- 預約示範 👋
- 社群 Discord 💭
- 我們的電子郵件 ✉️ ishaan@berri.ai / krrish@berri.ai