文档 · 接入指南

llm 命令行接 TopxAI：extra-openai-models.yaml

2026-09-19

在 llm 的 extra-openai-models.yaml 里登记 TopxAI 模型，api_base 填 https://ai.topxea.com/v1，密钥用 llm keys set 存，然后在 shell 里直接提问。

Simon Willison 的 llm 从配置目录里的一个 YAML 文件读取额外的 OpenAI 兼容模型。每个 TopxAI 模型一条。

登记模型

llm keys set topxai            # 粘贴自动路由的 TopxAI 密钥
cat > "$(dirname "$(llm keys path)")/extra-openai-models.yaml" <<'EOF'
- model_id: claude-sonnet-5-5
  model_name: claude-sonnet-5-5
  api_base: https://ai.topxea.com/v1
  api_key_name: topxai
  supports_tools: true
  vision: true
- model_id: gpt-6.1-sol
  model_name: gpt-6.1-sol
  api_base: https://ai.topxea.com/v1
  api_key_name: topxai
  supports_tools: true
  vision: true
- model_id: kimi-k3
  model_name: kimi-k3
  api_base: https://ai.topxea.com/v1
  api_key_name: topxai
  supports_tools: true
EOF
llm models | grep -i topxea

api_key_name 指向 llm keys set 存的密钥，YAML 里不放秘密。model_id 是命令行上用的名字，model_name 是发给 TopxAI 的名字，两者可以不同（比如 model_id: sonnet 当短别名）。

提问

llm -m claude-sonnet-5-5 "Say hello in one sentence."
llm -m gpt-6.1-sol -s "Answer in JSON" "List three ports of Portugal"
cat main.go | llm -m kimi-k3 "Explain this file"

llm logs -n 1 显示上一次的请求和回复；扣费看 TopxAI 的用量日志。

Responses 接口

给 GPT 条目加 responses: true，请求就走 /v1/responses 而不是 Chat Completions；GPT 系列两个接口 TopxAI 都提供。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

llm 命令行接 TopxAI：extra-openai-models.yaml

登记模型

提问

Responses 接口

不通时

相关