胜算云 胜算云 文档中心 ↗ 精益社区

主账号管理员入门

第一次使用企业网关？从主站登录开始，按顺序准备员工账号和项目，再让员工完成第一次调用。

1. 先认识企业、账号和项目

企业网关把团队的模型接入、权限、用量和记录集中管理。以给研发团队接入 AI 为例：主账号准备企业账号和“研发”项目，给员工分配角色与模型权限；员工使用自己的项目 API Key 调用。

概念负责什么例子
企业承载共同的账号、项目、供应商与管理配置你所在的组织
企业账号确定谁能登录，以及能否进入企业管理员工小李的子账号
项目按业务或团队隔开模型、成员与使用记录研发测试、内部助手
项目角色决定成员在项目里能做什么，以及用量限额只使用模型，或管理项目
项目 API Key让应用代表当前成员在当前项目调用模型内部助手服务使用的个人调用凭证

2. 从胜算云主站进入企业网关

  1. 打开胜算云登录页。
  2. 使用手机号和验证码登录；未注册手机号通过验证码登录即注册。已有账号可切换密码登录。
  3. 主站登录成功后，打开右上角账号菜单，点击“企业网关”。
  4. 进入网关直接使用已有名称；需要修改时，从左上角企业菜单进入。参见企业名称。

3. 创建企业账号

  1. 进入企业管理的“账号管理”，点击“新建账号”。
  2. 在“单个创建”填写姓名和有效的 11 位手机号；账号 ID 由系统生成，手机号不能与其他有效子账号重复。
  3. 选择账号级身份，设置 8–16 位、同时包含字母和数字的初始密码，并再次确认。
  4. 可以在“加入项目（可选）”同时选择项目和角色，也可以创建后再配置；财务对账人员不加入项目。
  5. 点击“确认创建”，在列表核对姓名、身份和项目关系；将登录地址、手机号和初始密码安全交给员工。

新建账号的单个创建表单

填写姓名、手机号、账号级身份和初始密码；加入项目可在创建时完成，也可稍后配置。

4. 选择一个项目角色

项目角色决定员工在项目里可以查看和操作什么。已有合适的角色就直接选择；没有合适的再创建。

  1. 进入企业管理的“项目角色”，点击“新建角色模板”。
  2. 确认角色的操作权限和用量限额符合员工职责；具体可用模型还需在目标项目中配置。
  3. 如果新建了角色，保存后再继续。

5. 创建或选择项目

进入企业管理的“项目管理”。如果列表里已经有 Default Project 或其他合适的项目，直接选择；没有合适的项目再创建一个。后面的成员、模型和调用记录都会放在这个项目里。

6. 将账号加入项目并绑定角色

  1. 如果创建账号时已配置目标项目和角色，直接核对关系；否则进入目标项目的“项目成员”。
  2. 点击添加成员，选择刚创建的企业账号。
  3. 为员工绑定上一步选择的项目角色并提交。
  4. 回到成员列表，确认员工已经出现在当前项目中。

7. 检查项目里有可用模型

进入目标项目的“模型管理”，确认列表里至少有一个员工可以使用的模型。记下这个模型的名称或模型 ID，员工第一次调用时会用到。

8. 让员工登录并找到 Default API Key

  1. 将企业网关登录地址、已绑定手机号和初始密码安全交给员工。
  2. 员工登录后，进入刚才加入的项目。
  3. 打开“项目 API Key”，找到系统提供的 Default API Key。
  4. 复制并妥善保存这个 Key，后面调用模型时需要填写。

9. 填写调用信息

如果使用 Agent 或应用平台，兼容接口选择 OpenAI Compatible。Base URL 从当前项目的接入信息中复制，API Key 填写员工自己的 Default API Key，模型填写该项目允许使用的模型 ID。不要修改地址中的项目路径，也不要重复追加 /v1。

10. 完成第一次调用

员工可以在 Agent 或应用平台里发一条简单消息，也可以复制下面的 Shell、Python 或 JavaScript 示例运行。收到模型返回的内容，就说明这次调用已经成功。

Shell

export SSY_API_KEY="YOUR_PROJECT_API_KEY"
export SSY_BASE_URL="YOUR_PROJECT_BASE_URL" # 从当前项目复制，保留项目和版本路径

curl --fail-with-body --max-time 60 "$SSY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $SSY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v3",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

Python

import os
import requests

response = requests.post(
    f"{os.environ['SSY_BASE_URL']}/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['SSY_API_KEY']}"},
    json={
        "model": "deepseek/deepseek-v3",
        "messages": [{"role": "user", "content": "你好"}],
        "stream": False,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch(
  `${process.env.SSY_BASE_URL}/chat/completions`,
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.SSY_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "deepseek/deepseek-v3",
      messages: [{ role: "user", content: "你好" }],
      stream: false,
    }),
  }
);

if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

预期响应示例（200 OK）

{
  "id": "20250410143202432620157mDT6DvdC",
  "provider": "OpenRouter",
  "model": "deepseek/deepseek-v3",
  "object": "chat.completion",
  "created": 1744266722,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮你？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 4,
    "completion_tokens": 9,
    "total_tokens": 13
  }
}

11. 在调用日志验证结果

  1. 回到刚才使用的项目，打开“调用日志”。
  2. 按调用时间找到刚才那条记录；如果响应中有请求 ID，也可以用请求 ID 查找。
  3. 确认记录里的账号、API Key 和模型与刚才使用的一致。

12. 第一次调用成功后还可以做什么