---
title: "[Beta] 根據請求中繼資料進行路由"
url: "/docs/tutorials/tag_management"
canonical_url: "https://docs.litellm.ai/docs/tutorials/tag_management"
type: "docs"
last_updated: "2026-10-08"
related:
  - "/docs/tutorials/scim_litellm"
  - "/docs/tutorials/proxy_features_safety"
---
# [Beta] 根據請求中繼資料進行路由

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


根據請求中繼資料建立路由規則。

## 設定 {#setup}

將以下內容加入您的 litellm proxy 設定 yaml 檔案。

```yaml showLineNumbers title="litellm proxy config.yaml"
router_settings:
  enable_tag_filtering: True # 👈 Key Change
```

## 1. 建立標籤 {#1-create-a-tag}

在 LiteLLM UI 中，前往 Experimental > Tag Management > Create Tag。

建立一個名為 `private-data` 的標籤，並且只選取具有此標籤的請求允許使用的模型。建立後，您會在 Tag Management 頁面看到該標籤。

## 2. 測試標籤路由 {#2-test-tag-routing}

現在我們將測試基於標籤的路由規則。

### 2.1 無效模型 {#21-invalid-model}

此請求會失敗，因為我們送出 `tags=["private-data"]`，但模型 `gpt-5.6-terra` 不在 `private-data` 標籤允許的模型中。

<br />

以下是使用 OpenAI Python SDK 傳送相同請求的範例。
**OpenAI Python SDK**

```python showLineNumbers
from openai import OpenAI

client = OpenAI(
    api_key="sk-<your-litellm-api-key>",
    base_url="http://0.0.0.0:4000/v1/"
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[
        {"role": "user", "content": "Hello, how are you?"}
    ],
    extra_body={
        "tags": ["private-data"]
    }
)
```

**cURL**

```bash
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": "Hello, how are you?"
    }
  ],
  "tags": ["private-data"]
}'
```

<br />

### 2.2 有效模型 {#22-valid-model}

此請求會成功，因為我們送出 `tags=["private-data"]`，而模型 `us.anthropic.claude-sonnet-5` 在 `private-data` 標籤允許的模型中。

以下是使用 OpenAI Python SDK 傳送相同請求的範例。

**OpenAI Python SDK**

```python showLineNumbers
from openai import OpenAI

client = OpenAI(
    api_key="sk-<your-litellm-api-key>",
    base_url="http://0.0.0.0:4000/v1/"
)

response = client.chat.completions.create(
    model="us.anthropic.claude-sonnet-5",
    messages=[
        {"role": "user", "content": "Hello, how are you?"}
    ],
    extra_body={
        "tags": ["private-data"]
    }
)
```

**cURL**

```bash
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": "us.anthropic.claude-sonnet-5",
  "messages": [
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ],
  "tags": ["private-data"]
}'
```

## 其他標籤功能 {#additional-tag-features}
- [在請求標頭中傳送標籤](https://docs.litellm.ai/docs/proxy/tag_routing#calling-via-request-header)
- [基於標籤的路由](https://docs.litellm.ai/docs/proxy/tag_routing)
- [依標籤追蹤支出](/docs/proxy/cost_tracking#custom-tags)
- [為虛擬金鑰、團隊設定預算](/docs/proxy/users)

## Related pages

- [LiteLLM 的 SCIM](https://docs.litellm.ai/docs/tutorials/scim_litellm.md)
- [Proxy: Features & Safety](https://docs.litellm.ai/docs/tutorials/proxy_features_safety.md)