入门指南#

    梧柏API 是什么#

    梧柏API 是 AI 模型聚合中转平台：在兼容 OpenAI 接口风格的前提下，通过统一 Base URL 与 API Key 调用多家模型（Chat、图像、视频、音频等）。

    接入三要素#

    项说明
    Base URLhttps://api.whbai.com/v1（OpenAI 兼容路径）
    API Key在控制台「API 令牌」创建，请求头 Authorization: Bearer sk-xxx
    Model控制台「支持模型」或 GET /v1/models
    模型请求使用上表的 API Key。账户管理接口使用下一节的系统访问令牌。

    系统访问令牌#

    系统访问令牌用于调用账户管理接口（例如查询当前账号）。在已登录控制台的前提下生成：
    1.
    左侧「个人」打开「个人设置」。
    2.
    切到页签「账户&安全」。
    3.
    在「API调用令牌」中找到「系统访问令牌」，点击「生成令牌」。
    生成成功后，新令牌会写入剪贴板，并显示在卡片中（默认打码）。眼睛图标可查看全文，复制图标可再复制一次。页顶的 ID: 是用户 ID，点击可复制。
    每次点击「生成令牌」都会作废上一枚令牌并签发新值。刷新页面后不再回显，需要再次生成才能拿到明文。
    调用管理接口时同时带上下面两个请求头：
    头值
    AuthorizationBearer <系统访问令牌>（Bearer 可省略）
    New-Api-User个人设置页顶的用户 ID，与令牌所属账号一致

    推荐学习路径#

    1.
    5 分钟 快速接入（Python）
    2.
    异步任务通用说明（视频 / Suno / Kling 等必读）
    3.
    门户「接口参考」中的各平台 OpenAPI

    与官方 API 的关系#

    默认：改 base_url 指向，模型名使用支持的 ID
    进阶：部分平台提供原生路径（如 /kling/*、/suno/*），见门户对应平台文档

    常见错误#

    现象可能原因
    invalid character '<' looking for beginning of valueBase URL 或路径错误，上游返回了 HTML
    401Key 无效或已禁用
    管理接口 401未带 New-Api-User，或该头与令牌所属用户不一致；或令牌已因再次「生成令牌」失效
    用系统访问令牌请求 /v1 返回 401模型接口要使用「API 令牌」中的 sk-xxx
    模型不存在模型名拼写错误或当前分组无权限
    更多排错见各平台 OpenAPI 中的 x-error-playbook。
    Built with