与黎 · 互市团队使用教程
从创建团队到上传账号、调用 API、使用团团查看额度,一步一步完成。本文的网页版与飞书版使用同一份正文。更新日期:2026-10-07。
本文介绍当前团队功能的操作方法,不代表支付与交易已经开放。支付、购买、分成与结算暂不开放;上传账号不等于充值,也不承诺获得上传收益。
一、第一次使用,先看这一页
管理员最短路线:用自己的与黎账号登录 → 创建团队 → 保存管理口令和邀请码 → 邀请成员 → 成员上传后系统检测额度并自动启用,管理员核对结果 → 管理员与成员分别创建自己的团队 API Key → 做一次真实请求 → 团团登录查看权限内额度。
普通成员最短路线:用自己的与黎账号登录 → 输入管理员给的邀请码加入团队 → 上传自己的账号 → 等额度检测通过、自动启用 → 创建本人团队 API Key → 在软件填入团队 API 地址 → 查询模型并做一次真实请求 → 用同一个与黎账号登录团团。
| 你要做什么 | 打开哪个页面 |
|---|---|
| 注册或登录与黎站账号 | 账号中心 |
| 创建团队、加入团队、管理账号、领取 API Key | 成员与管理员 |
| 上传或官方授权自己的账号 | 添加团队账号 |
| 看当前身份可见的团队账号额度 | 我的团队额度 |
| 下载团团 Windows 桌面应用 | 团团下载页 |
网页版地址可直接复制到浏览器地址栏打开。需要登录时,先按页面完成与黎站登录,再回到团队页;不要拿上游 ChatGPT 账号密码去登录与黎站。
账号、团队与四种凭据分别是什么
与黎站账号是你在网站和团团中的身份。上游账号是你自己的 ChatGPT / Codex、Claude 等平台账号,用于给团队提供模型调用能力。团队是与黎站上的团队空间,不是指上游服务商的 Team 订阅套餐。
| 名称 | 作用 | 使用位置 | 保管人 |
|---|---|---|---|
| 与黎站登录密码或第三方登录 | 证明你的与黎站身份 | 网站登录页、团团登录页 | 本人 |
管理口令,yuli_manage_ 开头 |
解锁本团队的管理操作 | 团队页的“管理口令”输入框 | 团队管理员 |
成员邀请码,yuli_invite_ 开头 |
加入管理员指定的团队 | 团队页的“成员邀请码”输入框 | 被邀请成员 |
本人团队 API Key,yuli_private_ 开头 |
从本人软件调用本团队的启用账号 | 软件的 API Key 输入框 | 本人 |
这四种内容不能互换。普通成员收到的是邀请码,不是管理口令;软件使用的是本人团队 API Key,不是邀请码。每个人创建自己的 Key,不共用管理员的登录身份或调用 Key。
团队 API 与主站普通 API 是两组配置:本教程的 Key 不一定以 sk- 开头,必须配本教程的团队 API 地址。主站普通 API 的 sk- Key 和 https://api.yulitongxing.com/v1 不要与这套团队配置混用。
团队共享与“只看本人”不是一回事
加入团队后,成员的 API 调用会使用该团队已启用的可用账号,不是只使用成员自己上传的账号。默认“只看本人额度”限制的是逐号明细的查看范围,不是给每人划了一份独享预算;成员同时能看到团队总额度汇总。
管理员可以允许某个成员查看全队的逐号账号额度,但该成员仍然只能看自己的 API 用量,仍然没有管理员权限。额度可见范围、调用范围、管理权限是三件不同的事。
二、先注册并登录自己的与黎站账号
- 打开账号中心。尚未登录时,页面会引导到与黎站登录页。
- 已有与黎站账号就按页面登录;第一次使用按登录页提供的注册入口创建自己的账号。账号信息、验证方式与第三方 Auth 选项以当前页面为准。
- 如果忘记密码,使用登录页的找回入口处理。不要创建多个账号来回切换,否则网站、团队 Key 和团团可能对应不同身份。
- 登录后打开成员与管理员,继续创建或加入团队。
与黎站登录和第四部分的供应商官方 Auth 是两个不同流程:前者决定你是谁、属于哪个团队;后者授权一个上游账号给团队使用。
三、管理员创建团队、邀请成员并解锁管理
3.1 创建团队:同时获得管理口令与邀请码
- 登录后打开成员与管理员。
- 在“创建团队”的“团队名称”中填写一个容易识别的名称,例如“社区创作团队”。
- 点“创建团队并获取管理口令”。创建者自动成为管理员,“我的团队”会出现新团队。
- 页面会分别显示“管理员口令(仅给管理员)”和“成员邀请码(发给成员)”。它们默认隐藏,点各自的“显示 / 隐藏”查看,或点“复制”保存。
- 将管理口令保存在自己能找到的位置;将邀请码单独保存,方便发给准备加入的成员。两者不要保存在同一条群公告里。
- 确认保存后点“已保存,关闭”。新团队创建后本页会自动完成本次管理解锁,不需要马上再输入一次。
完成标志:“当前团队”显示正确团队,“身份”显示管理员,管理口令与邀请码都已保存。
管理口令不是账号密码,后台也不能还原其明文。初次创建或重新生成时显示的完整值应当场保存,刷新页面不会重新展示旧值。若已丢失且没有其他仍可解锁的团队管理员,请联系站点维护处理,不要把重新注册账号当作找回口令。
3.2 再次进入团队:先解锁,再管理
- 打开团队页,在“当前团队”选择要管理的团队。多个团队时,先核对团队名称,避免误操作另一个团队。
- 找到“团队管理员”区域,将已保存的本团队口令粘贴到“管理口令”输入框。
- 点“解锁管理”,等待“团队管理已解锁”。随后页面会列出本团队成员。
- 现在可以管理账号启停、删除、重置卡、成员角色、额度查看权限,以及成员的重置卡与删除开关。
解锁只保留在当前页面内存中;刷新页面、切换团队或管理解锁过期后,需要再次输入管理口令。当前解锁有效期约 15 分钟。口令错误连续多次时会短暂暂停解锁,核对正确口令后再试,不要持续重复输入。
只有已登录且仍是这个团队管理员的人才能用管理口令解锁。普通成员就算知道口令,也不会自动获得管理员身份。
3.3 给成员发邀请码
管理员把该团队的成员邀请码发给准备加入的成员,并告诉他团队名称与团队入口。成员先登录自己的与黎站账号,再把邀请码填进“加入团队”区域。
当前邀请码可供多名成员使用,不是一人一次的注册码。需要停止旧邀请继续招人时,管理员解锁后点“重新生成成员邀请码”,复制并保存新码。旧邀请码随即失效;已经加入的成员不会因此退出,现有 API Key 也不是靠换邀请码撤销的。
3.4 为不同成员设置额度查看范围
管理员解锁后,在成员列表找到要设置的人。列表用与黎用户 ID 标识成员,可以先让成员确认自己的账号身份,避免只靠猜测认人。
- 点“允许查看全队额度”:让该成员查看本团队全部账号的逐号额度。
- 点“改为仅本人额度”:让该成员只查看自己的账号逐号额度,以及团队总额度汇总。
- 点“设为管理员”或“设为成员”:改变该成员的管理角色;角色与额度查看权限分别处理。
- 点“移出团队”:移除成员,并使其本团队 Key 对后续请求失效,其贡献账号也会停止参与新调用。
新加入成员默认仅本人额度:能看自己的账号逐号额度和团队总额度汇总,看不到别人的逐号明细、标签和邮箱。管理员无论自身查看设置如何,都可以看全队账号。API 用量另有固定规则:管理员看全队,普通成员始终只看本人;允许看全队额度不会变成允许看全队成员的 API 用量。
如果提升某人为管理员,还需要把管理口令单独交给他,他才能解锁管理。移除、降级或退出时,团队必须保留至少一位管理员;最后一位管理员应先安排另一位管理员再退出。
3.5 更换管理口令
在已解锁状态下点“重新生成管理口令”。保存新口令后,使用新口令重新解锁。旧口令与旧管理解锁立即失效,其他管理员也需要使用新口令重新解锁。
更换管理口令不等于撤销成员的 API Key。停止某人的调用要撤销对应 Key 或移出该成员,不能只换管理口令。
四、成员加入团队并上传自己的账号
4.1 用邀请码加入
- 登录自己的与黎站账号,打开成员与管理员。
- 将管理员发来的邀请码粘贴到“加入团队”的“成员邀请码”输入框,不要填管理口令。
- 点“加入团队”,等待“已加入团队,现在可以添加自己的账号、领取本人 API Key”。
- 在“我的团队”的“当前团队”中选中刚加入的团队,核对名称和“成员”身份。
- 点“上传或授权我的账号”,或直接打开添加团队账号。
加入团队不会自动上传你的官方账号,也不会把个人登录转成共享登录。退出后重新加入,身份默认恢复为成员,旧 Key 和被停用的贡献账号不会自动恢复。
4.2 官方 Auth 授权:优先选择
- 在添加页“所属团队”选择正确团队。没有团队可选时,先回团队页创建或加入,不要找旧公共号池链接代替。
- 在“账号平台”选择你拥有的平台。页面当前提供 ChatGPT / Codex、Claude、Google Antigravity、Kimi、Grok / xAI,具体授权是否可用取决于官方服务和当前账号。
- 点“通过官方 Auth 添加”。新标签页会打开供应商官方授权网页,添加页也会显示“打开官方授权页”链接。
- 在官方页面登录准备上传的账号,核对身份,按官方提示同意授权。官方密码只在对应官方页面填写,与黎添加页不要求供应商密码。
- 授权结束后回到与黎添加页,等待自动检查,必要时点“刷新授权结果”。
- 如果官方授权后跳到
localhost且浏览器显示打不开,不要立即重新授权。将浏览器地址栏中的完整返回地址复制,粘贴到添加页“官方授权后的返回地址”,点“提交返回地址”。它可能长得像http://localhost:1455/auth/callback?...,实际地址以此次授权返回为准。 - 页面显示账号已添加后,回到团队页点“刷新团队数据”,核对账号与当前团队。
普通成员上传后待管理员启用;管理员本人上传默认启用。 “已添加”与“已启用”是两个状态,成员看到“待管理员启用 / 已停用”时,请本团队管理员处理,再测试调用。
一个团队空间已有未完成授权时,先完成或点“停止等待”取消,再开启下一次授权。授权任务约 10 分钟过期;过期后使用新任务的新地址,不复用旧返回地址。
4.3 已有登录 JSON:上传文件添加
已有登录文件时,可以展开“已有登录 JSON 文件?上传文件添加”。推荐仍然优先官方 Auth,文件导入用于已有文件的情况。
- 确认“所属团队”没有选错。
- 找到自己的登录 JSON。Codex 常见路径:Windows 为
C:\Users\你的用户名\.codex\auth.json,Mac / Linux 为~/.codex/auth.json。选择auth.json,不是config.toml、聊天记录或整个文件夹。 - 在文件区域选择
.json文件,再点“上传到当前团队”。支持自己的 Codexauth.json或 CPA 导出的登录 JSON;能否接受取决于文件格式与凭据是否有效。 - 看到导入结果后,回团队页点“刷新团队数据”。成员账号等待管理员启用;管理员本人账号默认启用。
- 启用后再做第五部分的模型查询和真实请求。
登录 JSON 相当于账号钥匙,只交到这个添加页,不发进社区群或聊天。文件导入可能与本机继续使用同一份登录发生刷新冲突;希望本机继续使用时,优先给团队单独走官方 Auth。文件通常只有几 KB,选到很大的文件时先检查是不是选错了。
4.4 团团添加与设备码备选
团团的添加窗口会先读取本人所属团队。选择团队后走官方 Auth,授权结果仍绑定到该团队;文件上传会打开带当前团队的网页添加页。
团队设备码没有独立接入公共设备授权服务。团团中选到设备码备选时,会打开同一团队的网页添加页,请继续使用“通过官方 Auth 添加”。不要把它当作已完成团队设备码授权,也不要绕回旧公共号池导入。
五、创建本人团队 API Key 并连接软件
5.1 先领取自己的 Key
- 在团队页的“我的团队”中选择目标团队。
- 点“创建本人团队 API Key”。
- 页面显示“本人团队 API Key(不要发给别人)”。点“复制”并保存;完整 Key 只在创建时显示。
- 同一区域会显示本人令牌记录和“撤销”按钮。忘记完整 Key 时,创建新的,再撤销不再使用的旧 Key,不需要找管理员的 Key 来代用。
创建 Key 不会自动启用账号。当前团队必须有至少一个启用、登录有效、额度可用且支持所选模型的账号,才有可调用能力。
5.2 在软件里填写这组信息
| 软件输入框 | 填什么 |
|---|---|
| 服务类型 / Provider | OpenAI-compatible;按客户端支持选择 Chat Completions 或 Responses |
| Base URL / API 地址 | https://console.yulitongxing.com/pool/api/private/v1 |
| API Key / 密钥 | 本人创建的 yuli_private_ 开头的团队 Key |
| Model / 模型 | 此团队 Key 返回的模型列表中的完整 ID |
如果软件要求填“根地址”并自己添加 /v1,按软件说明去掉末尾 /v1;最终请求不能出现 /v1/v1。Base URL 输入框不要再加 /chat/completions 或 /responses,除非它明确要求完整请求地址。
如果某个软件把 Key 强制限制为 sk- 开头,不要自行给团队 Key 加 sk-,也不要截断 Key。选择允许自定义 OpenAI-compatible 凭据的软件或设置入口。
这里的“API 登录”指在软件中填写地址和 Key。网页登录、团团登录仍使用与黎站账号。管理口令不填到 API Key 栏,上游官方账号也不靠团队 Key 登录。
5.3 先查询模型,再选最好的模式
这套团队 API 只调用本团队已启用账号能提供的模型。不同团队、不同平台、不同套餐和额度状态,可用列表可能不同;“支持的最好模型”不能只看名称,也不是全站所有模型都会出现。
本轮已通过真实隔离账号验证的高推理配置:gpt-6-astra + Responses + reasoning.effort="xhigh"。 2026-10-06 的实际响应返回 gpt-6-astra 和 xhigh,不只是模型目录出现名称。复杂推理任务可优先测试这组配置;它须先出现在你本人团队 Key 的模型列表中,并由你自己完成一次请求。该实测不代表所有团队都有该模型,也不代表普通社区成员已经走完真人接入。
正确顺序是:查询本 Key 的 /models → 从返回列表选完整模型 ID → 核对该模型支持的协议与 reasoning 参数 → 做一次短请求 → 再用于正式任务。模型目录列出一个 ID 不等于该模型此刻一定能完成调用,所以最后一步不能省。
困难分析、代码推理等任务可使用当前模型支持的高推理强度。Responses 常见写法为 "reasoning": {"effort": "high"},Chat Completions 常见写法为 "reasoning_effort": "high",但不是每个模型都接受它们。只有模型能力说明或管理员实测确认支持时才添加;xhigh 等值同样不能一概使用。
/models 若只返回 ID 而没有能力字段,请管理员提供该模型的已验证协议与最高支持强度,不从名称猜能力。推理强度并不改变团队角色,也不让成员拥有独享额度;它可能增加耗时与用量。gpt-6-astra + xhigh 是这次实测推荐配置,不是永远固定或对全部模型通用的默认。
5.4 Python 示例:查模型,选协议,发第一条请求
第一次使用先确保电脑有 Python。在终端运行 python --version 能显示版本,再安装示例依赖一次:
python -m pip install requests
把下面代码保存为 team-api-check.py。在文件所在目录打开终端,运行 python team-api-check.py,按提示粘贴本人 Key。Key 输入时不会显示字符,这是正常的。复制模型列表中的一个完整 ID,选择已验证支持的协议;首次连通测试建议先不启用强推理。
import getpass
import json
import requests
BASE_URL = "https://console.yulitongxing.com/pool/api/private/v1"
TOKEN = getpass.getpass("粘贴本人团队 API Key 后按 Enter:").strip()
session = requests.Session()
session.headers.update({
"Authorization": "Bearer " + TOKEN,
"Accept": "application/json",
})
def call(path, payload=None):
if payload is None:
response = session.get(BASE_URL + path, timeout=120)
else:
response = session.post(BASE_URL + path, json=payload, timeout=180)
print("HTTP 状态:", response.status_code)
if not response.ok:
raise RuntimeError(
"请求未成功,请按教程检查状态码、团队账号启用状态、模型与协议。"
)
return response.json()
def response_text(result, protocol):
if protocol == "chat":
choices = result.get("choices", [])
return choices[0].get("message", {}).get("content", "") if choices else ""
parts = []
for item in result.get("output", []):
for part in item.get("content", []):
if part.get("type") == "output_text":
parts.append(part.get("text", ""))
return "\n".join(parts)
try:
catalog = call("/models")
models = catalog.get("data", [])
ids = [row["id"] for row in models if isinstance(row, dict) and "id" in row]
if not ids:
raise RuntimeError("未返回可用模型,请管理员检查团队启用账号。")
print("本 Key 的模型列表:")
print("\n".join(ids))
MODEL_ID = input("复制一个完整模型 ID:").strip()
if MODEL_ID not in ids:
raise ValueError("模型 ID 不在刚刚返回的列表中。")
protocol = input("已确认支持的协议:填 chat 或 responses:").strip()
if protocol not in {"chat", "responses"}:
raise ValueError("协议只填写 chat 或 responses。")
effort = input("已确认支持的强度 high / xhigh;首次基础测试直接 Enter:").strip()
if effort not in {"", "high", "xhigh"}:
raise ValueError("只填写空值、已确认支持的 high 或 xhigh。")
if effort == "xhigh" and (MODEL_ID != "gpt-6-astra" or protocol != "responses"):
raise ValueError("本教程只实测了 gpt-6-astra 的 Responses xhigh,其它配置请另行验证。")
if protocol == "chat":
payload = {
"model": MODEL_ID,
"messages": [{"role": "user", "content": "请只回复:团队 API 已连通。"}],
"stream": False,
}
if effort:
payload["reasoning_effort"] = effort
result = call("/chat/completions", payload)
else:
payload = {
"model": MODEL_ID,
"input": "请只回复:团队 API 已连通。",
"stream": False,
}
if effort:
payload["reasoning"] = {"effort": effort}
result = call("/responses", payload)
print("实际返回模型:", result.get("model", "上游未提供"))
answer = response_text(result, protocol)
print("模型回复:", answer or "未返回文本,请检查此模型的协议和返回内容。")
print("上游返回的本次用量:")
print(json.dumps(result.get("usage"), ensure_ascii=False, indent=2))
except (requests.RequestException, ValueError, RuntimeError, KeyError) as error:
print("检查未完成:", str(error))
finally:
session.close()
连通成功应同时满足:模型目录有返回、推理请求 HTTP 成功、回复中有可辨认文本。如果成功状态没有文本,检查协议、返回结构和模型行为,不把保存配置或列出模型当作完整验收。
首次成功后再加已确认支持的强度验证。若本人目录包含 gpt-6-astra,可选 responses 并输入 xhigh 测试本轮推荐配置。若参数报错,核对该模型实际支持的参数;明确不支持时删除该项,以该模型支持的模式调用,不通过伪造模型名来强行获得高模式。
5.5 curl 示例:模型、Chat Completions、Responses
以下代码适合 Git Bash、macOS / Linux 的 Bash 终端。Windows PowerShell 用户优先用上面的 Python 示例,避免复制 Bash 换行符到 PowerShell。MODEL_ID 必须替换为第一步返回且已核验支持的完整 ID。
先隐藏输入 Key,并设置团队 API 地址;关闭这个终端后变量不再保留:
BASE_URL='https://console.yulitongxing.com/pool/api/private/v1'
read -r -s -p '粘贴本人团队 API Key:' TOKEN
printf '\n'
curl -sS --fail-with-body "$BASE_URL/models" \
-H "Authorization: Bearer $TOKEN"
查看返回 JSON 的 data 列表,将其中一个完整 ID 填到下面:
read -r -p '粘贴已核验的完整模型 ID:' MODEL_ID
Chat Completions 基础请求,先用于已确认支持此协议的模型:
curl -sS --fail-with-body "$BASE_URL/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
--data "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"请只回复:团队 API 已连通。\"}],\"stream\":false}"
Responses 的 xhigh 示例使用本轮已实测的 gpt-6-astra。先确认它出现在本人 Key 的模型目录中;其它模型不能直接照搬此强度。首次基础测试可删除 reasoning 字段:
curl -sS --fail-with-body "$BASE_URL/responses" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
--data '{"model":"gpt-6-astra","input":"解释一个并发程序出现死锁的必要条件。","reasoning":{"effort":"xhigh"},"stream":false}'
若模型只支持 Chat Completions 且确认接受 high,可在基础 Chat 请求 JSON 中添加 "reasoning_effort":"high"。同一个参数不能在所有模型间照搬。较旧 curl 没有 --fail-with-body 时,去掉它并查看实际 HTTP / 错误 JSON,或使用 Python 示例。
用完当前终端中的 Key,可执行:
unset TOKEN MODEL_ID BASE_URL
5.6 用团团一键连接 Codex / Claude Code
第一次建议先在一个可新建自定义服务的软件中测试,不直接覆盖正在用的官方登录。记录原服务类型、地址和模型,把团队配置保存为一个独立服务。
团队专用 Key 的一键接入需要团团 0.3.12 或以上。当前 0.3.12 已在官网下载页发布。 先确认正在运行的版本为 0.3.12 或更新版本,不将旧版的一键按钮当作已经支持团队路由。
- 在网页团队页创建并复制本人的
yuli_private_Key。 - 在团团设置中展开“连接 Codex / Claude Desktop / Claude Code”,这是已有 API Key 的配置入口。在“API Key”中粘贴本人团队 Key,“Key 类型”选择“团队 API Key(从成员与管理员领取)”。粘贴
yuli_private_Key 会识别团队类型,但仍需核对当前选项。 - 点击“模型 ID(团队必选)”的输入框,读取本团队真实模型目录;必要时点“刷新模型列表”。搜索并选择一个明确的完整模型 ID,不能留空。团队模式没有“留空使用全部模型”的选项;留空点写入时会提示“团队模式请先选择模型。”,不会写入配置。
- 要使用 Codex,在“客户端”选择“Codex 桌面端”,再从重新读取的目录选模型。Responses 模型可选择
gpt-6-astra(若本团队目录存在);启用 xhigh 仍按模型与客户端实际支持的推理设置处理,一键写入地址和模型不等于自动设置了 xhigh。 - 要使用 Claude Code,在“客户端”选择“Claude Code”,重新读取目录并选本团队已验证支持 Messages 协议的模型。切换客户端或 Key 类型会清空已选模型,需要重新选择。
gpt-6-astra的 Responses 实测不自动证明 Claude Code / Messages 或 Claude Desktop 支持,不能强行套用同一模型。 - 点“写入配置”,核对随后显示的“确认写入 Codex(会替换原登录)”或对应 Claude Code 确认文字,再点一次确认。团团会先备份原登录与配置,再写入团队 Key、对应团队地址和模型。看到写入成功后,完全退出并重新打开对应客户端。
- 在客户端发送一条短请求。仅看到“已接入”还不算模型调用完成;需看到实际文本回复。
- 想恢复原登录与配置时,使用同一区域的“一键还原”,再完全退出并重新打开客户端。
团团在团队 Key 模式下不会把这个 Key 送到主站普通余额接口去查询余额。它读取的是团队模型能力;与黎网页登录仍负责账号额度视图和成员权限。团队 Key 识别与地址匹配失败时,应检查连接模式与版本,不给 Key 加 sk- 前缀。
“清除 Key”只清空当前输入框,不会撤销网站上的 Key,也不会自动还原客户端。撤销到团队页操作;恢复原配置点“一键还原”。
Codex 的团队地址为 https://console.yulitongxing.com/pool/api/private/v1;Claude Code 使用对应 Messages 根地址 https://console.yulitongxing.com/pool/api/private,由客户端按协议构造请求。手动配置不要把这两种客户端根地址混用。Claude Desktop 对模型格式另有要求,其实验连接不作为这次 Codex / Claude Code 使用步骤的验收替代。
六、管理员启用账号,检查成员是否真正能用
6.1 启用成员上传的账号
- 管理员打开团队页,选择正确团队并“解锁管理”。
- 在“团队账号”里核对账号名称、平台和状态。成员上传的新账号应显示“待管理员启用 / 已停用”。
- 点对应账号的“启用”,等待“账号状态已更新”。启用后应显示“已启用”。
- 让成员用本人 Key 查询模型并发一条短请求;不要用管理员自己的成功请求代替成员验证。
- 在团队页点“刷新团队数据”,核对本人或全队 API 用量,并查看账号额度的更新时间。
启用只是允许账号参与本团队新调用,不保证供应商登录、剩余额度和模型支持始终有效。出现错误时按第九部分处理,不反复上传覆盖已有账号。
6.2 停用与删除有什么区别
停用让账号停止参与后续调用,保留团队中的记录,后续由管理员再次启用。删除移除该账号的团队登录绑定,后续不能再调用它;需要时由账号本人重新授权或上传。
管理员先核对当前团队和账号,再点“停用”或“删除”。删除需要确认。团队账号的普通成员没有这些管理按钮,想撤回自己的账号时联系管理员处理。
如果只是某台设备不再使用,应撤销那个设备的本人 API Key;这不会自动删除团队账号。停止上游订阅也不是这里的删除操作,二者分别处理。
七、团团登录与不同额度数字的含义
7.1 下载、登录与刷新
- 打开团团下载页,下载当前已发布的 0.3.12 或以上 Windows 包。团队一键接入至少需要 0.3.12,不从旧聊天附件找安装包。
- 完整解压到固定文件夹,再运行
QuotaPet.exe,不要在 ZIP 里直接运行。 - 在团团点击登录,使用你加入团队的同一个与黎站账号。团团复用控制台登录态,不让你用团队管理口令或
yuli_private_Key 代替登录。 - 登录后刷新额度,先看更新时间,再核对账号列表。如果多次使用了不同与黎身份,先确认当前登录的是哪一个。
- 团团显示由服务器按你的团队身份和额度可见规则提供;添加账号时先选择目标团队。当前权限内有多个团队的账号时,核对账号所属与显示范围,不把各团队数字当作同一个独享预算。
团团是额度查看与操作入口,不是为每位成员重新发一份供应商预算。它显示哪些账号不会改变团队 API 使用全队启用账号的规则。
7.2 四种数字别混在一起
| 页面数字 | 它说明什么 | 它不说明什么 |
|---|---|---|
| 供应商账号剩余百分比、额度窗口、重置时间 | 对应上游账号可观察到的使用窗口 | 不是你个人独享额度,也不是人民币余额 |
| 团队页 API 请求次数、输入 / 输出 tokens | 团队 API 记录到的请求与上游返回的 token 用量 | 不是上游订阅的美元余额 |
| 团团中的与黎站余额 / 用量 | 当前与黎站身份相关的计费信息 | 不等于团队某个上游账号的剩余百分比 |
| 管理员团队汇总 | 管理员能看本团队的账号和成员调用汇总 | 不代表普通成员也能看其它人的 API 用量 |
管理员默认能看全队账号;新成员默认只看自己上传的账号。管理员允许某个成员看全队额度后,只改变供应商账号查看范围。该普通成员仍只能看自己的 API 请求与 tokens,不能管理账号、成员或口令。
本人可见账号为空但 API 能调用,不一定是异常。 例如你尚未上传账号、默认仅本人额度,但团队已有别人的启用账号,那么本人 Key 可以使用团队共享能力,而你的供应商账号列表仍可能为空。反过来,看见账号额度也不保证账号已启用或该模型能调用。
上游没有返回 token 用量时,团队页显示“上游未返回”以及“未返回用量”的次数,不能把它当作零消耗。失败请求与成功请求分别统计;服务页面不会凭 token 数直接编造美元收益。
7.3 为什么网页与团团刚开始不一致
先检查三件事:登录身份是否相同、账号可见规则是否相同、更新时间是否相近。刷新网页和团团后再比较。登录过期、读取失败或旧缓存不是实际额度为零;不要用管理员账号替换成员账号来“解决”权限差异。
如需分享问题截图,遮住口令、Key、登录文件以及不需要暴露的账号信息,只保留页面名、时间和错误提示。
八、撤销 Key、撤回账号、退出团队与轮换
8.1 停止某个本人 API Key
在团队页选择对应团队,在本人令牌记录旁点“撤销”。旧 Key 的后续请求会失效。新设备使用时创建新 Key,确认新配置能调用后再撤销旧设备的 Key。
撤销不会自动重新创建 Key,也不会删除上游账号。完整旧 Key 本来就不会在列表重新展示,忘记时创建新 Key 即可。
8.2 撤回自己上传的团队账号
普通成员联系本团队管理员,说明账号与所属团队;管理员解锁后先停用,必要时删除,并检查它已不再参与新调用。上传不自动授予删除权限。
退出或被移出团队后,本人成员资格失效、本人团队 Key 失效,本人贡献账号也会停用;管理员可清理相关登录。重新加入不会重新激活旧 Key 或贡献账号。
8.3 退出团队
在团队页选择要退出的团队,点“退出当前团队”,核对确认提示后继续。后续不能再使用这个团队的旧 Key。当前已经进行中的请求不承诺全部立刻中断,退出影响后续鉴权与调用。
最后一位管理员不能直接退出或被移除,应先设置另一位管理员、交接必要口令并确认对方可管理,再退出。仅将某人设为管理员但没交接口令,不算管理交接完成。
8.4 一台电脑切换不同成员
团团先退出登录,网页也确认当前与黎身份,再让下一位成员登录自己的账号。重新刷新账号与数字,不沿用上一位成员的缓存、团队 Key 或管理解锁。
九、常见问题:按出现的现象处理
| 现象 | 怎么处理 |
|---|---|
| 团队页显示正在准备 / 503 | 这是团队服务尚未就绪或暂不可用,稍后刷新;不要用旧公共号池绕过团队 |
| 注册或登录没有完成 | 先完成与黎站登录,再回团队页;与黎账号与供应商账号不是同一身份 |
| 加入时提示提交信息不正确 / 权限失效 | 核对复制的是当前邀请码、没有空格或漏字符;管理员轮换后旧码不可再用 |
| 创建后找不到管理口令 | 口令只在创建或轮换时展示,刷新不重新展示;已有可解锁管理员可轮换,否则联系站点维护 |
| 普通成员输入管理口令仍不能管理 | 管理口令不替代管理员身份,由现任管理员检查角色设置 |
| 点启用、成员管理时提示权限或口令失效 | 核对当前团队,重新“解锁管理”;刷新、切换、超时或轮换后要重新解锁 |
| 授权成功后 localhost 打不开 | 保留完整返回地址,粘贴到添加页“官方授权后的返回地址”并提交 |
| 授权结果一直等待 | 点“刷新授权结果”;未完成任务先取消,过期后重新开始,不复用旧回调 |
| 账号已添加但暂时不能调用 | 普通成员上传默认待管理员启用;还要检查登录、额度、模型协议 |
| 文件太大或格式不支持 | 选本人登录 JSON,不选 config、日志或压缩包;不确定时改走官方 Auth |
| 上传时提示账号已存在或归属冲突 | 先查当前团队的已有记录,联系管理员核对所属,不用改文件内容伪装另一账号 |
| API 401 / 团队 API Key 已失效 | 检查 Key 完整性、地址匹配、是否撤销以及本人是否仍是成员;必要时创建新的 |
| API 404 | 检查地址是否只有一层 /v1,是否使用 /models、/chat/completions 或 /responses 的正确方法 |
| API 503 / 没有可调用账号 | 管理员检查团队中是否有启用、登录有效、额度可用的账号 |
| 模型不存在、权限错误或协议错误 | 重新查询本人 Key 的模型目录,核对完整 ID 和支持的协议,再做短请求 |
| reasoning 参数错误 | 先移除未确认支持的强度参数,按此模型已验证能力配置;不要默认所有模型接受 xhigh |
| 团团把团队 Key 当成普通主站 Key,或请求普通余额失败 | 检查版本是否为 0.3.12 或以上,选择团队 API 接入;不应使用团队 Key 查普通平台余额 |
| 写入时提示团队模式请先选择模型 / MODEL_REQUIRED | 点击“模型 ID(团队必选)”,从本人团队目录明确选一个模型再写入;留空时不会修改配置 |
| 团团一键接入后没有 xhigh | 一键接入主要写入地址、Key 与模型,另按模型与客户端支持设置推理强度;本轮实测为 gpt-6-astra Responses xhigh |
| API 502 或网络超时 | 稍后检查服务与上游状态;请求可能已到上游,不要立刻重复高消耗任务 |
| 团团显示少于管理员 | 默认成员只看本人,管理员看全队;需要全队额度视图时请管理员调整查看权限 |
| 团团没有供应商账号但 API 可用 | 团队调用共享启用账号,本人的可见列表可以为空;按第七部分分清查看与调用 |
| 用量显示上游未返回 | 该次上游响应没有可解析用量,不代表零 tokens,也不能推算为美元余额 |
| 退出团队后重新加入,旧 Key 仍失效 | 这是正常行为,创建新 Key;贡献账号需要管理员重新核对后启用 |
| 无法移出最后一位管理员 | 先设置另一位管理员并交接口令,再操作 |
| 本机官方登录被挤下线 | 登录文件可能共用刷新凭据,优先改用单独官方 Auth,再检查本机登录 |
反馈时提供:与黎用户名或用户 ID、团队名称、发生时间、操作页面、HTTP 状态码或页面提示、脱敏截图。不要发送完整 API Key、管理口令、邀请码、供应商密码或登录 JSON 正文。
十、接入完成前逐项确认
管理员确认
- 团队名称、管理员身份正确,管理口令与邀请码分别保存。
- 至少一位成员用自己的与黎账号完成加入,不使用管理员账号代验。
- 成员账号上传到正确团队,由管理员启用,状态已更新。
- 成员本人 Key 实际完成模型目录查询和一条模型请求。
- 成员与管理员分别查看额度和 API 用量,显示范围符合第七部分。
- 会撤销本人 Key、停用 / 删除账号、管理成员、轮换口令与邀请,并理解它们的区别。
成员确认
- 我用自己的与黎账号登录,知道当前团队与自己的角色。
- 我上传的账号在正确团队中;需要调用时已请管理员启用。
- 我创建了本人团队 Key,配的是本教程的团队 API 地址。
- 我使用真实返回的完整模型 ID,并完成了一条请求。
- 团团与网页登录同一个与黎身份;我知道显示的额度不等于独享预算。
- 我知道如何撤销 Key、联系管理员撤回账号,以及退出当前团队。
以上结果应由实际使用者确认,不仅看页面是否能打开。后续教程更新统一从同一份正文生成,网页与飞书保持一致。