鸿渐 HuGen 快速上手：一个 Key，调用万物大模型

鸿渐（HuGen）是太殷造物旗下的 AI 模型聚合平台：统一 OpenAI / Anthropic 两套接口， 多上游智能路由与故障转移，按量计费、用量可审计，并可选端到端加密调用。

本文带你完成从登录到第一次成功调用的全过程（约 5 分钟）。

1. 登录：不需要单独注册

鸿渐与 TyDash 共用同一套身份（TyDash 的 Supabase 账号）。访问 https://hugen.tydash.net 会跳转登录；如果你已经登录过 tydash.net， 由于 Cookie 域是 .tydash.net，直接进入控制台即可。

内测阶段仅对团队成员与受邀测试账号开放。

2. 创建 API Key

控制台 → API Keys → 新建，选择类型：

类型	计费方式	适用
PLAN	消耗套餐配额（余额不足时回落到余额）	个人/团队日常使用
MODEL	纯按量，独立于套餐配额	给第三方应用嵌入

密钥形如 sk-hj-…，只在创建时展示一次，请立即妥善保存。

3. OpenAI 兼容调用

基址：https://hugen.tydash.net/v1

curl https://hugen.tydash.net/v1/chat/completions \
  -H "Authorization: Bearer $HUGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"用一句话解释意群切分"}],"max_tokens":64}'

Python（官方 openai SDK，改 base_url 即可）：

from openai import OpenAI
client = OpenAI(api_key="sk-hj-...", base_url="https://hugen.tydash.net/v1")
print(client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
).choices[0].message.content)

Node.js：

import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.HUGEN_API_KEY, baseURL: "https://hugen.tydash.net/v1" });
const r = await client.chat.completions.create({ model: "deepseek-chat", messages: [{ role: "user", content: "你好" }] });
console.log(r.choices[0].message.content);

可用模型

GET /v1/models 列出当前账号可用的模型。模型名后带 : 后缀表示指定来源分组 （例如 deepseek-chat 与自部署副本并存时），不带后缀由路由层按健康/成本/延迟自动选择。

4. Anthropic 兼容调用

基址：https://hugen.tydash.net/anthropic（同时支持 /v1/messages）。

curl https://hugen.tydash.net/anthropic/v1/messages \
  -H "x-api-key: $HUGEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","max_tokens":64,"messages":[{"role":"user","content":"Say OK"}]}'

流式（SSE）与非流式都支持；Claude Code 等 Anthropic 客户端把 base_url 指到上面的地址即可。

计费口径与 OpenAI 接口完全一致——Anthropic 层是协议翻译，不是第二套计费。

5. 常见问题

现象	原因与处理
401 invalid_api_key	Key 拼错/已停用；控制台重新生成
402 insufficient_balance	余额不足；充值或在套餐页升级
503 no_upstream	该模型暂时没有可用上游，稍后重试或换模型
响应 model 与请求不同	路由到了同族副本（如自部署节点），属预期

6. 下一步

• 想跑意群切分 + 配音流水线：见《在鸿渐里调用 LingoFlow》。
• 需要端到端加密（服务端只见密文）：见《鸿渐加密客户端》。