快速开始
HeteroFlow 是本站的异构算力与大模型调度产品。快速开始。从登录到第一次成功调用大模型 API 的完整路径：登录平台、界面导览、获取 API 密钥、发起 OpenAI 兼容调用、理解额度与限流。SDK 接入只需替换网关地址与密钥两个参数，业务代码零改动。
快速开始
> 从登录到第一次成功调用大模型 API 的完整路径：登录平台、界面导览、获取 API 密钥、发起 OpenAI 兼容调用、理解额度与限流。SDK 接入只需替换网关地址与密钥两个参数，业务代码零改动。
1. 登录平台
平台支持三种登录方式。无论哪种方式，平台不向个人发放测试账号：账号密码由平台管理员开户提供，企业统一身份账号由贵司身份系统（CAS / LDAP）提供。
| 方式 | 适用人群 | 说明 |
|---|---|---|
| 账号密码登录 | 管理员开户的用户 | 在登录页输入账号与密码 |
| CAS 统一登录 | 已接入公司统一认证的员工 | 登录页点击统一登录按钮（按钮名以登录页实际显示为准） |
| LDAP 直连登录 | 管理员启用 LDAP 后 | 使用公司域账号密码登录 |
使用 CAS 统一登录
1. 打开平台登录页，点击统一登录按钮；
2. 浏览器跳转到公司统一身份认证系统，输入贵司分配的账号密码完成认证；
3. 认证通过后自动跳回平台，无需再做任何操作。
首次 CAS 登录成功后，平台会自动为您创建账号（JIT 开户），并按身份系统返回的信息同步您的部门、角色与所属租户——无需任何人手工开号。此后每次登录都会重新同步组织信息：若您在身份系统中被停用，再次登录平台将被拒绝。
遇到登录问题
- 账号密码登录被锁或遗忘密码：联系平台管理员重置；
- CAS 页面报错：多为公司身份系统侧问题，确认账号状态后重试；持续失败联系管理员检查统一登录配置。
2. 登录后的界面
普通用户登录后进入开发者门户，平台管理与开发使用是分离的两套界面。平台首页是公开的模型广场（未登录也可浏览已发布的模型、端点能力与公示价格，并可按端点类型筛选可用模型）。门户内的工作区导航如下：
> 模型卡片可能带有展示状态徽标，由管理员设置：正常展示 / 已隐藏 / 部分展示 / 无法展示——「部分展示」表示同名匹配的模型中有一部分被隐藏或暂无可用渠道，「无法展示」表示该模型当前没有可用渠道、不出现在广场列表。
| 导航项 | 用途 |
|---|---|
| API 密钥 | 创建、管理调用密钥，查看密钥状态 |
| 游乐场（Playground） | 在浏览器里直接对话试模型，支持从模型广场带模型跳转（受平台模块开关控制，未显示即管理员未开放） |
| 使用日志 | 查看本人每一次 API 调用的记录、计费与错误（含绘图 / 任务分区） |
| 个人资料 | 个人信息与偏好设置 |
| 安全与访问 | 两步验证、Passkey、登录会话管理（敏感操作前需在此开启二次验证） |
| 钱包 | 余额、在线充值、兑换码、订阅与扣费偏好 |
| 密钥申请（Applications） | 提交应用密钥申请、跟踪审批轮次与已签发密钥（页面标题「APIKey 申请」；涉及数据等级的正式密钥走这里） |
管理员登录后额外拥有管理后台（渠道、模型、额度、用户、告警、报表、系统设置等），门户页与管理台顶部互有快捷切换入口。
3. 获取 API 密钥
调用 API 必须使用密钥（sk- 开头）。两条路径：
- 申请审批链（推荐，涉及数据等级的正式密钥必走）：进入工作区 →「密钥申请」（页面标题「APIKey 申请」）→ 新建申请，写清用途、数据安全等级（公开 / 内部 / 敏感）、端点场景与模型范围，提交后由本租户管理员审批（申请人不能自批；被驳回可修改重提）。批准后系统签发密钥并自动绑定申请单声明的等级与场景——数据等级字段的实际值就来自这张被批准的单。
- 直接新建：工作区 →「API 密钥」→ 新建，填写名称、勾选允许的场景（聊天、向量化、图像生成、语音合成、语音转写等；不勾选 = 不限制场景——按需勾选可收窄密钥能力，泄露时损失更小）。注意：数据安全等级字段仅管理员可设，普通成员由此新建的密钥不带自选等级；敏感级密钥请走申请审批链。
密钥明文仅显示一次，请立即复制并妥善保存（如密码管理器）。关闭弹窗后无法再次查看，只能重新创建。
4. 第一次调用
平台网关兼容 OpenAI 接口协议。以对话补全为例（模型名以模型广场公示为准）：
# ① 确认 Base URL 与密钥
export API_BASE="https://api.example.com"
export API_KEY="sk-你的密钥"
# ② 查可用模型（或直接在模型广场浏览）
curl -s https://api.example.com/api/portal/models
# ③ 发起调用（model 换成你要用的模型名）
curl -s https://api.example.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "your-model-name",
"messages": [
{"role": "user", "content": "你好，请介绍一下你自己。"}
]
}'成功响应（HTTP 200）关键字段：
| 字段 | 含义 |
|---|---|
choices[0].message.content | 模型回复正文 |
choices[0].finish_reason | 结束原因（stop 为正常结束） |
usage | 本次调用的 token 计量（prompt / completion / total） |
常用端点一览（完整清单见端点总表）：
| 能力 | 端点 |
|---|---|
| 对话补全 | POST /v1/chat/completions |
| 文本向量化 | POST /v1/embeddings |
| 图像生成 | POST /v1/images/generations |
| 语音合成 | POST /v1/audio/speech |
| 语音转写 | POST /v1/audio/transcriptions |
SDK 接入只需替换 base_url（https://api.example.com/v1）与 api_key 两个参数。调用记录可在工作区 →「使用日志」中逐条核对。
每个响应都带 X-Oneapi-Request-Id 响应头——报障时把这个编号提供给管理员，可在调用日志中精确定位那一次请求。
5. 理解额度
管理员可对密钥 / 模型配置四个维度的额度，超限后请求返回 HTTP 429 并附明确错误码（完整错误码见错误码总表）：
| 维度 | 超限错误码 | 提示文案示例 |
|---|---|---|
| 每日调用次数（次日零点重置） | daily_request_limit_exceeded | 密钥当日调用次数已达上限（N 次/日） |
| QPS（每秒请求数） | rate_limit_exceeded | 密钥调用频率已达上限（N 次/秒） |
| 并发数（同时在途请求） | rate_limit_exceeded | 密钥并发请求已达上限（N 个） |
| 月度额度（按 token 或金额计量，本月熔断） | monthly_quota_exceeded | 密钥月度 Token 额度已用尽（上限 N tokens），本月调用被熔断 |
未配置额度的维度不受限制。
关于计费的公平性：被平台明确拒绝的请求（429/403 等）不计数不扣费；选路失败（无可用渠道，503）不消耗日调用额度——没真正转发出去的请求，系统会回滚其日计数；只有真正进入模型调用的请求才会计数计费（已转发后上游失败的按实际用量结算）。额度配置调整在提交后的下一请求生效。用量与剩余额度在「使用日志」与「钱包」页可自助核对。