AI Gateway 模型管理：cz-cli 命令行操作

AI Gateway 的模型管理通常通过 Studio 界面操作，cz-cli 提供了对应的命令行接口——创建和配置虚拟 Key、浏览可用模型、注册为 cz-cli Agent LLM。适合自动化脚本、CI/CD 流水线，也适合在终端中快速查询模型列表。

核心流程

预览

涉及的命令

cz-cli ai-gateway key list

cz-cli ai-gateway key create

cz-cli ai-gateway key upsert

cz-cli ai-gateway key get

cz-cli ai-gateway key enable/disable

cz-cli ai-gateway key delete

cz-cli ai-gateway key set-quota

cz-cli ai-gateway model list

cz-cli agent llm add ... --provider clickzetta

管理虚拟 Key

列出已有 Key

cz-cli ai-gateway key list

{ "data": [ { "id": 716, "alias": "qiliang", "vApiKey": "50db****7f61", "status": 1 } ], "count": 1, "ai_message": "Page 1, showing 1 of 1 virtual keys." }

id

alias

vApiKey

status

创建 Key

cz-cli ai-gateway key create my_key

{ "data": { "id": 736, "alias": "my_key", "vApiKey": "c081****dae5" }, "ai_message": "Virtual key created. To use it with the agent run: cz-cli agent llm add my_key --provider clickzetta --api-key <vApiKey> --base-url https://... --use" }

vApiKey

key create

key list

a12f****950c

get

disable

enable

delete

set-quota

model list

创建或更新 Key（upsert，推荐）

upsert

# 基础创建 cz-cli ai-gateway key upsert prod_key \ --quota 1000000 --period monthly # 创建后直接注册为 Agent LLM（跳过手动 add） cz-cli ai-gateway key upsert my_agent \ --quota 500000 --period daily \ --add-to-llm --use

upsert 参数说明：

--quota

--period

daily

weekly

monthly

total

--route-type

default

provider

byok

--providers

route-type=provider

--provider-sort

route-type=default

price

throughput

latency

--private-keys

route-type=byok

--add-to-llm

~/.clickzetta/profiles.toml

[llm.<name>]

--use

修改配额

cz-cli ai-gateway key set-quota \ --key "<完整 vApiKey>" \ --period daily \ --quota 2000000

{ "data": { "id": 716, "period": "daily", "quota": 2000000 } }

启用 / 禁用 / 删除

# 需要完整的 vApiKey，alias 和脱敏值均不可用 cz-cli ai-gateway key disable "<完整 vApiKey>" cz-cli ai-gateway key enable "<完整 vApiKey>" cz-cli ai-gateway key delete "<完整 vApiKey>"

{"data": {"id": 738, "status": 0}}

{"data": {"id": 738, "status": 1}}

{"data": {"id": 738, "deleted": true}}

浏览可用模型

cz-cli ai-gateway model list "<完整 vApiKey>"

a12f****950c

{"data":[],"count":0}

key create

输出为该 Key 可见的模型列表，格式如下（实际返回 42 个模型）：

{ "data": [ {"modelIdentifier": "qwen/qwen3.7-max", "modelName": "Qwen3.7 Max"}, {"modelIdentifier": "byteplus/dola-seed-2-0-pro", "modelName": "ByteDance Dola Seed 2.0 pro"}, {"modelIdentifier": "minimax/MiniMax-M2.7", "modelName": "MiniMax M2.7"}, {"modelIdentifier": "openai/gpt-4.1", "modelName": "GPT-4.1"}, {"modelIdentifier": "deepseek/deepseek-v4-pro", "modelName": "DeepSeek V4 Pro"} ], "count": 42 }

modelIdentifier

deepseek/deepseek-v4-pro

AI_COMPLETE()

modelName

DeepSeek V4 Pro

modelInvokeStatus

模型标识符格式为

<提供商>/<模型名>

注册为 Agent LLM

cz-cli 内置的 AI Agent 需要一个 LLM 驱动，AI Gateway 的虚拟 Key 可以作为 Agent LLM 使用。

方式一：upsert 时一步完成

cz-cli ai-gateway key upsert my_agent \ --quota 500000 --period daily \ --add-to-llm --use

{ "data": { "id": 737, "alias": "demo-key", "vApiKey": "ed42****f942" } }

--add-to-llm

~/.clickzetta/profiles.toml

[llm.my_agent]

--use

方式二：手动注册

从

key get

cz-cli agent llm add my_agent \ --provider clickzetta \ --api-key "<完整虚拟 Key>" \ --base-url "https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1" \ --use

provider 为

clickzetta

--base-url

AI Gateway Base URL 按地域：

https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1

https://ap-shanghai-tencentcloud-aimesh.api.clickzetta.com/gateway/v1

https://ap-southeast-1-aws-aimesh.api.singdata.com/gateway/v1

测试连接

cz-cli agent llm test my_agent

{ "data": { "message": "[llm.my_agent] test passed.", "name": "my_agent", "provider": "clickzetta", "url": "https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions", "probe": "chat.completions", "source": "llm" } }

查看和切换 LLM

cz-cli agent llm show # 查看所有 LLM 配置 cz-cli agent llm list # 列出所有 [llm.*] 条目 cz-cli agent llm use my_agent # 切换活跃 LLM

用法示例

场景：为开发团队批量创建 AI Gateway Key

# 为每个开发者创建 Key for name in alice bob carol; do cz-cli ai-gateway key upsert "dev_${name}" \ --quota 100000 --period daily \ --route-type default --provider-sort price done # 查看所有 Key cz-cli ai-gateway key list

场景：查询特定供应商的模型

# 获取 Key 并查看可用模型 cz-cli ai-gateway model list "<完整 vApiKey>" # 筛选 DeepSeek 供应商的模型 cz-cli ai-gateway model list "<完整 vApiKey>" --format json | \ python3 -c " import json, sys data = json.load(sys.stdin) for m in data['data']: if m['modelIdentifier'].startswith('deepseek'): print(m['modelIdentifier'], m['modelName']) "

场景：注册 Agent LLM 并切换

# 一步完成 cz-cli ai-gateway key upsert agent_prod \ --quota 5000000 --period monthly \ --add-to-llm --use # 验证 cz-cli agent llm test agent_prod

注意事项

key list

key get

alias

dev_alice

prod_agent

staging_test

--format json

--api-key

--base-url

--add-to-llm

agent llm add

clickzetta

openai

openai-compatible

anthropic

bedrock

google

azure

openrouter

相关文档

• AI Gateway 快速开始 — 在 Studio 中创建 API Key 和路由策略
• AI Gateway 产品介绍 — Endpoint 管理、配额、监控
• AI Gateway 实战：用 SQL 调用大模型 — AI_COMPLETE 文本模式
• 在 SQL 中分析图片 — AI_COMPLETE 图像模式
• cz-cli 安装配置指南 — cz-cli 环境搭建