跳至主要內容

CLF AI Gateway

https://clfaigateway.dev/docs

CLF AI Gateway 是一個相容於 OpenAI 的閘道,可提供開放權重模型。它是獨立服務,且不隸屬於 Cloudflare;若要查看 Cloudflare 自家的推論產品,請參閱 Cloudflare Workers AI

提示

設定 model=clf_ai_gateway/<model> 以透過 CLF AI Gateway 路由請求。最新的模型清單位於 https://clfaigateway.dev/models,以及來自 GET /v1/models

API 金鑰​

import os

os.environ["CLF_AI_GATEWAY_API_KEY"] = "sk-gw-..."
os.environ["CLF_AI_GATEWAY_API_BASE"] = "https://api.clfaigateway.dev/v1" # optional, this is the default

CLF_AI_GATEWAY_API_BASE 只需要在您將 LiteLLM 指向不同端點時設定。若不設定,則會使用 https://api.clfaigateway.dev/v1

使用範例​

from litellm import completion
import os

os.environ["CLF_AI_GATEWAY_API_KEY"] = "sk-gw-..."

response = completion(
model="clf_ai_gateway/glm-5.3",
messages=[{"role": "user", "content": "What character was Wall-e in love with?"}],
)
print(response)

使用範例 - 串流​

from litellm import completion
import os

os.environ["CLF_AI_GATEWAY_API_KEY"] = "sk-gw-..."

response = completion(
model="clf_ai_gateway/glm-5.3",
messages=[{"role": "user", "content": "What character was Wall-e in love with?"}],
stream=True,
)

for chunk in response:
print(chunk)

推理​

閘道上的每個模型都是推理模型,因此所有模型都接受 reasoning_effort。各模型採用的等級不同,而 LiteLLM 會從模型對應表讀取,而不是假設只有一組固定值

from litellm import completion
import os

os.environ["CLF_AI_GATEWAY_API_KEY"] = "sk-gw-..."

response = completion(
model="clf_ai_gateway/glm-5.3",
messages=[{"role": "user", "content": "How many r's are in strawberry?"}],
reasoning_effort="high",
)
print(response)

推理 token 會計入 completion_tokens,因此它們會以輸出價格計費,而不是另外計費

與 LiteLLM Proxy Server 一起使用​

  1. 將模型加入您的 config.yaml
model_list:
- model_name: my-model
litellm_params:
model: clf_ai_gateway/glm-5.3
api_key: os.environ/CLF_AI_GATEWAY_API_KEY
  1. 啟動 proxy
$ litellm --config /path/to/config.yaml
  1. 傳送請求
import openai

client = openai.OpenAI(
api_key="litellm-proxy-key",
base_url="http://0.0.0.0:4000",
)

response = client.chat.completions.create(
model="my-model",
messages=[{"role": "user", "content": "What character was Wall-e in love with?"}],
)

print(response)

支援的模型​

以下所有模型都支援工具呼叫、JSON 模式與推理

模型上下文視窗影像
clf_ai_gateway/glm-5.31,048,576否
clf_ai_gateway/glm-5.3-flash1,048,576是
clf_ai_gateway/glm-5.2262,144否
clf_ai_gateway/glm-4.7-flash131,072否
clf_ai_gateway/kimi-k2.7-code262,144是
clf_ai_gateway/kimi-k2.6262,144是
clf_ai_gateway/deepseek-v4-pro1,048,576否
clf_ai_gateway/deepseek-v4-flash1,048,576否
clf_ai_gateway/qwen3.8-27b262,144是

支援的參數​

參數類型說明
frequency_penaltynumber根據新 token 在文字中的出現頻率來懲罰它們
max_completion_tokensinteger要產生的 token 最大數量
max_tokensinteger要產生的 token 最大數量
ninteger要產生的完成數量
parallel_tool_callsboolean模型是否可以同時呼叫多個工具
presence_penaltynumber根據 token 是否已出現在目前為止的文字中來懲罰它們
reasoning_effortstring模型在回答前進行多少推理
response_formatobject回應格式,例如 {"type": "json_object"}
seedinteger用於決定性結果的取樣種子
stopstring/arrayAPI 停止產生 token 的序列
streamboolean是否串流回應
stream_optionsobject串流選項,例如 {"include_usage": true}
temperaturenumber控制隨機性
tool_choicestring/object控制模型呼叫哪個工具(如果有)
toolsarray模型可使用的工具清單
top_pnumber控制 nucleus sampling
userstring使用者識別碼

提示詞快取​

閘道會自動快取可辨識的提示詞前綴。快取的輸入 token 會以 prompt_tokens_details.cached_tokens 回來,並依模型的快取輸入價格計費,而 LiteLLM 會從模型對應表讀取該價格以進行成本追蹤

LiteLLM Enterprise
為正式環境打造的 SSO/SAML、稽核記錄、支出追蹤、多團隊管理與防護欄。
深入瞭解 →