与黎 · 汇流 / 互市成员与管理员

与黎 · 互市团队使用教程

从创建团队到上传账号、调用 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 用量,仍然没有管理员权限。额度可见范围、调用范围、管理权限是三件不同的事。

二、先注册并登录自己的与黎站账号

  1. 打开账号中心。尚未登录时,页面会引导到与黎站登录页。
  2. 已有与黎站账号就按页面登录;第一次使用按登录页提供的注册入口创建自己的账号。账号信息、验证方式与第三方 Auth 选项以当前页面为准。
  3. 如果忘记密码,使用登录页的找回入口处理。不要创建多个账号来回切换,否则网站、团队 Key 和团团可能对应不同身份。
  4. 登录后打开成员与管理员,继续创建或加入团队。

与黎站登录和第四部分的供应商官方 Auth 是两个不同流程:前者决定你是谁、属于哪个团队;后者授权一个上游账号给团队使用。

三、管理员创建团队、邀请成员并解锁管理

3.1 创建团队:同时获得管理口令与邀请码

  1. 登录后打开成员与管理员。
  2. 在“创建团队”的“团队名称”中填写一个容易识别的名称,例如“社区创作团队”。
  3. 点“创建团队并获取管理口令”。创建者自动成为管理员,“我的团队”会出现新团队。
  4. 页面会分别显示“管理员口令(仅给管理员)”和“成员邀请码(发给成员)”。它们默认隐藏,点各自的“显示 / 隐藏”查看,或点“复制”保存。
  5. 将管理口令保存在自己能找到的位置;将邀请码单独保存,方便发给准备加入的成员。两者不要保存在同一条群公告里。
  6. 确认保存后点“已保存,关闭”。新团队创建后本页会自动完成本次管理解锁,不需要马上再输入一次。

完成标志:“当前团队”显示正确团队,“身份”显示管理员,管理口令与邀请码都已保存。

管理口令不是账号密码,后台也不能还原其明文。初次创建或重新生成时显示的完整值应当场保存,刷新页面不会重新展示旧值。若已丢失且没有其他仍可解锁的团队管理员,请联系站点维护处理,不要把重新注册账号当作找回口令。

3.2 再次进入团队:先解锁,再管理

  1. 打开团队页,在“当前团队”选择要管理的团队。多个团队时,先核对团队名称,避免误操作另一个团队。
  2. 找到“团队管理员”区域,将已保存的本团队口令粘贴到“管理口令”输入框。
  3. 点“解锁管理”,等待“团队管理已解锁”。随后页面会列出本团队成员。
  4. 现在可以管理账号启停、删除、重置卡、成员角色、额度查看权限,以及成员的重置卡与删除开关。

解锁只保留在当前页面内存中;刷新页面、切换团队或管理解锁过期后,需要再次输入管理口令。当前解锁有效期约 15 分钟。口令错误连续多次时会短暂暂停解锁,核对正确口令后再试,不要持续重复输入。

只有已登录且仍是这个团队管理员的人才能用管理口令解锁。普通成员就算知道口令,也不会自动获得管理员身份。

3.3 给成员发邀请码

管理员把该团队的成员邀请码发给准备加入的成员,并告诉他团队名称与团队入口。成员先登录自己的与黎站账号,再把邀请码填进“加入团队”区域。

当前邀请码可供多名成员使用,不是一人一次的注册码。需要停止旧邀请继续招人时,管理员解锁后点“重新生成成员邀请码”,复制并保存新码。旧邀请码随即失效;已经加入的成员不会因此退出,现有 API Key 也不是靠换邀请码撤销的。

3.4 为不同成员设置额度查看范围

管理员解锁后,在成员列表找到要设置的人。列表用与黎用户 ID 标识成员,可以先让成员确认自己的账号身份,避免只靠猜测认人。

新加入成员默认仅本人额度:能看自己的账号逐号额度和团队总额度汇总,看不到别人的逐号明细、标签和邮箱。管理员无论自身查看设置如何,都可以看全队账号。API 用量另有固定规则:管理员看全队,普通成员始终只看本人;允许看全队额度不会变成允许看全队成员的 API 用量。

如果提升某人为管理员,还需要把管理口令单独交给他,他才能解锁管理。移除、降级或退出时,团队必须保留至少一位管理员;最后一位管理员应先安排另一位管理员再退出。

3.5 更换管理口令

在已解锁状态下点“重新生成管理口令”。保存新口令后,使用新口令重新解锁。旧口令与旧管理解锁立即失效,其他管理员也需要使用新口令重新解锁。

更换管理口令不等于撤销成员的 API Key。停止某人的调用要撤销对应 Key 或移出该成员,不能只换管理口令。

四、成员加入团队并上传自己的账号

4.1 用邀请码加入

  1. 登录自己的与黎站账号,打开成员与管理员。
  2. 将管理员发来的邀请码粘贴到“加入团队”的“成员邀请码”输入框,不要填管理口令。
  3. 点“加入团队”,等待“已加入团队,现在可以添加自己的账号、领取本人 API Key”。
  4. 在“我的团队”的“当前团队”中选中刚加入的团队,核对名称和“成员”身份。
  5. 点“上传或授权我的账号”,或直接打开添加团队账号。

加入团队不会自动上传你的官方账号,也不会把个人登录转成共享登录。退出后重新加入,身份默认恢复为成员,旧 Key 和被停用的贡献账号不会自动恢复。

4.2 官方 Auth 授权:优先选择

  1. 在添加页“所属团队”选择正确团队。没有团队可选时,先回团队页创建或加入,不要找旧公共号池链接代替。
  2. 在“账号平台”选择你拥有的平台。页面当前提供 ChatGPT / Codex、Claude、Google Antigravity、Kimi、Grok / xAI,具体授权是否可用取决于官方服务和当前账号。
  3. 点“通过官方 Auth 添加”。新标签页会打开供应商官方授权网页,添加页也会显示“打开官方授权页”链接。
  4. 在官方页面登录准备上传的账号,核对身份,按官方提示同意授权。官方密码只在对应官方页面填写,与黎添加页不要求供应商密码。
  5. 授权结束后回到与黎添加页,等待自动检查,必要时点“刷新授权结果”。
  6. 如果官方授权后跳到 localhost 且浏览器显示打不开,不要立即重新授权。将浏览器地址栏中的完整返回地址复制,粘贴到添加页“官方授权后的返回地址”,点“提交返回地址”。它可能长得像 http://localhost:1455/auth/callback?...,实际地址以此次授权返回为准。
  7. 页面显示账号已添加后,回到团队页点“刷新团队数据”,核对账号与当前团队。

普通成员上传后待管理员启用;管理员本人上传默认启用。 “已添加”与“已启用”是两个状态,成员看到“待管理员启用 / 已停用”时,请本团队管理员处理,再测试调用。

一个团队空间已有未完成授权时,先完成或点“停止等待”取消,再开启下一次授权。授权任务约 10 分钟过期;过期后使用新任务的新地址,不复用旧返回地址。

4.3 已有登录 JSON:上传文件添加

已有登录文件时,可以展开“已有登录 JSON 文件?上传文件添加”。推荐仍然优先官方 Auth,文件导入用于已有文件的情况。

  1. 确认“所属团队”没有选错。
  2. 找到自己的登录 JSON。Codex 常见路径:Windows 为 C:\Users\你的用户名\.codex\auth.json,Mac / Linux 为 ~/.codex/auth.json。选择 auth.json,不是 config.toml、聊天记录或整个文件夹。
  3. 在文件区域选择 .json 文件,再点“上传到当前团队”。支持自己的 Codex auth.json 或 CPA 导出的登录 JSON;能否接受取决于文件格式与凭据是否有效。
  4. 看到导入结果后,回团队页点“刷新团队数据”。成员账号等待管理员启用;管理员本人账号默认启用。
  5. 启用后再做第五部分的模型查询和真实请求。

登录 JSON 相当于账号钥匙,只交到这个添加页,不发进社区群或聊天。文件导入可能与本机继续使用同一份登录发生刷新冲突;希望本机继续使用时,优先给团队单独走官方 Auth。文件通常只有几 KB,选到很大的文件时先检查是不是选错了。

4.4 团团添加与设备码备选

团团的添加窗口会先读取本人所属团队。选择团队后走官方 Auth,授权结果仍绑定到该团队;文件上传会打开带当前团队的网页添加页。

团队设备码没有独立接入公共设备授权服务。团团中选到设备码备选时,会打开同一团队的网页添加页,请继续使用“通过官方 Auth 添加”。不要把它当作已完成团队设备码授权,也不要绕回旧公共号池导入。

五、创建本人团队 API Key 并连接软件

5.1 先领取自己的 Key

  1. 在团队页的“我的团队”中选择目标团队。
  2. 点“创建本人团队 API Key”。
  3. 页面显示“本人团队 API Key(不要发给别人)”。点“复制”并保存;完整 Key 只在创建时显示。
  4. 同一区域会显示本人令牌记录和“撤销”按钮。忘记完整 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 或更新版本,不将旧版的一键按钮当作已经支持团队路由。

  1. 在网页团队页创建并复制本人的 yuli_private_ Key。
  2. 在团团设置中展开“连接 Codex / Claude Desktop / Claude Code”,这是已有 API Key 的配置入口。在“API Key”中粘贴本人团队 Key,“Key 类型”选择“团队 API Key(从成员与管理员领取)”。粘贴 yuli_private_ Key 会识别团队类型,但仍需核对当前选项。
  3. 点击“模型 ID(团队必选)”的输入框,读取本团队真实模型目录;必要时点“刷新模型列表”。搜索并选择一个明确的完整模型 ID,不能留空。团队模式没有“留空使用全部模型”的选项;留空点写入时会提示“团队模式请先选择模型。”,不会写入配置。
  4. 要使用 Codex,在“客户端”选择“Codex 桌面端”,再从重新读取的目录选模型。Responses 模型可选择 gpt-6-astra(若本团队目录存在);启用 xhigh 仍按模型与客户端实际支持的推理设置处理,一键写入地址和模型不等于自动设置了 xhigh。
  5. 要使用 Claude Code,在“客户端”选择“Claude Code”,重新读取目录并选本团队已验证支持 Messages 协议的模型。切换客户端或 Key 类型会清空已选模型,需要重新选择。gpt-6-astra 的 Responses 实测不自动证明 Claude Code / Messages 或 Claude Desktop 支持,不能强行套用同一模型。
  6. 点“写入配置”,核对随后显示的“确认写入 Codex(会替换原登录)”或对应 Claude Code 确认文字,再点一次确认。团团会先备份原登录与配置,再写入团队 Key、对应团队地址和模型。看到写入成功后,完全退出并重新打开对应客户端。
  7. 在客户端发送一条短请求。仅看到“已接入”还不算模型调用完成;需看到实际文本回复。
  8. 想恢复原登录与配置时,使用同一区域的“一键还原”,再完全退出并重新打开客户端。

团团在团队 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 启用成员上传的账号

  1. 管理员打开团队页,选择正确团队并“解锁管理”。
  2. 在“团队账号”里核对账号名称、平台和状态。成员上传的新账号应显示“待管理员启用 / 已停用”。
  3. 点对应账号的“启用”,等待“账号状态已更新”。启用后应显示“已启用”。
  4. 让成员用本人 Key 查询模型并发一条短请求;不要用管理员自己的成功请求代替成员验证。
  5. 在团队页点“刷新团队数据”,核对本人或全队 API 用量,并查看账号额度的更新时间。

启用只是允许账号参与本团队新调用,不保证供应商登录、剩余额度和模型支持始终有效。出现错误时按第九部分处理,不反复上传覆盖已有账号。

6.2 停用与删除有什么区别

停用让账号停止参与后续调用,保留团队中的记录,后续由管理员再次启用。删除移除该账号的团队登录绑定,后续不能再调用它;需要时由账号本人重新授权或上传。

管理员先核对当前团队和账号,再点“停用”或“删除”。删除需要确认。团队账号的普通成员没有这些管理按钮,想撤回自己的账号时联系管理员处理。

如果只是某台设备不再使用,应撤销那个设备的本人 API Key;这不会自动删除团队账号。停止上游订阅也不是这里的删除操作,二者分别处理。

七、团团登录与不同额度数字的含义

7.1 下载、登录与刷新

  1. 打开团团下载页,下载当前已发布的 0.3.12 或以上 Windows 包。团队一键接入至少需要 0.3.12,不从旧聊天附件找安装包。
  2. 完整解压到固定文件夹,再运行 QuotaPet.exe,不要在 ZIP 里直接运行。
  3. 在团团点击登录,使用你加入团队的同一个与黎站账号。团团复用控制台登录态,不让你用团队管理口令或 yuli_private_ Key 代替登录。
  4. 登录后刷新额度,先看更新时间,再核对账号列表。如果多次使用了不同与黎身份,先确认当前登录的是哪一个。
  5. 团团显示由服务器按你的团队身份和额度可见规则提供;添加账号时先选择目标团队。当前权限内有多个团队的账号时,核对账号所属与显示范围,不把各团队数字当作同一个独享预算。

团团是额度查看与操作入口,不是为每位成员重新发一份供应商预算。它显示哪些账号不会改变团队 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 正文。

十、接入完成前逐项确认

管理员确认

  1. 团队名称、管理员身份正确,管理口令与邀请码分别保存。
  2. 至少一位成员用自己的与黎账号完成加入,不使用管理员账号代验。
  3. 成员账号上传到正确团队,由管理员启用,状态已更新。
  4. 成员本人 Key 实际完成模型目录查询和一条模型请求。
  5. 成员与管理员分别查看额度和 API 用量,显示范围符合第七部分。
  6. 会撤销本人 Key、停用 / 删除账号、管理成员、轮换口令与邀请,并理解它们的区别。

成员确认

  1. 我用自己的与黎账号登录,知道当前团队与自己的角色。
  2. 我上传的账号在正确团队中;需要调用时已请管理员启用。
  3. 我创建了本人团队 Key,配的是本教程的团队 API 地址。
  4. 我使用真实返回的完整模型 ID,并完成了一条请求。
  5. 团团与网页登录同一个与黎身份;我知道显示的额度不等于独享预算。
  6. 我知道如何撤销 Key、联系管理员撤回账号,以及退出当前团队。

以上结果应由实际使用者确认,不仅看页面是否能打开。后续教程更新统一从同一份正文生成,网页与飞书保持一致。