快速开始

三步完成第一次调用：选接口、拿密钥、发请求。

第一步：选接口

按用途选接口
想做的事	用哪类接口
在自己的程序或开发工具里调用大模型、生成视频	模型服务接口
让 AI 助手代用户找服务、制定经营计划、跟进订单	AI 助手接入接口
只查公开的服务、服务商、招标和商机信息	能力网公开接口（不需要密钥）
用程序调用诸葛军师站内的各项功能	平台能力共享接口
把企业内部系统和会员账户打通（任务、外包、采购）	会员接口
同步自己店铺的资料、商品和客户咨询	商家开放接口

第二步：创建密钥

登录后到对应页面创建。密钥只在创建时完整显示一次，请马上保存到安全的地方。

模型服务接口：在模型服务页创建密钥，密钥以 zg_live_ 开头。
AI 助手接入接口：在 AI 接入页创建接入密钥，密钥以 zk_ 开头。
平台能力共享接口：在功能接入页创建密钥，密钥以 zhuge_share_ 开头。
会员接口：在 API 接口页创建密钥，密钥以 zhuge_live_ 开头。
商家开放接口：在商家后台创建密钥，密钥以 zsk_ 开头。

模型服务按用量从余额扣费，第一次调用前请先在模型服务页充值。

第三步：发第一次请求

以模型服务为例。先把密钥放进环境变量 ZHUGE_API_KEY，再运行：

curl

curl https://www.zhugejunshi.com/api/v1/chat/completions \
  -H "Authorization: Bearer $ZHUGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "zhuge-text-fast", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'

Python

import os
import requests

resp = requests.post(
    "https://www.zhugejunshi.com/api/v1/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['ZHUGE_API_KEY']}"},
    json={"model": "zhuge-text-fast", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]},
    timeout=60,
)
resp.raise_for_status()
print(resp.json()["choices"][0]["message"]["content"])

返回 200 并带有回答就成功了。返回 401 说明密钥不对，402 说明余额不足，详见错误处理。可用模型列表用 GET /v1/models 查询。

在开发工具里使用

模型服务支持 Chat Completions / Responses / Messages 格式，Codex、Claude Code 可以直接接入；CC Switch 用户可以在模型服务页一键导入。

Codex 配置

# ~/.codex/config.toml
model = "zhuge-text-fast"
model_provider = "zhuge"

[model_providers.zhuge]
name = "诸葛军师模型服务"
base_url = "https://www.zhugejunshi.com/api/v1"
wire_api = "responses"
env_key = "ZHUGE_API_KEY"

Claude Code 环境变量

ANTHROPIC_BASE_URL=https://www.zhugejunshi.com/api
ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
ANTHROPIC_MODEL=zhuge-text-fast