用 API 把数字员工接进你的系统:OpenAI 兼容接入指南

除了网页,你也能用自己的程序调用数字员工平台。接口兼容 OpenAI——把现有 OpenAI SDK 的 base_url 指到本平台、api_key 换成平台签发的 sk_live_…,几乎零改造就能接进你的后端、工作流或自动化脚本。

为什么做成 OpenAI 兼容

市面上大量代码、SDK、低代码工具都按 OpenAI 的 /v1/chat/completions 约定写。兼容它意味着你不用学新 SDK:改两行配置(base_url 和 api_key)就能把请求切到平台,享受统一的用量计量、费用阀门与审计。

三步接入

1. 签发 API Key:管理员在「系统 · API 接入」新建一把 sk_live_…,明文只显示一次,请立即保存(平台只存哈希)。
2. 改配置:把 base_url 指到 https://highcadre.com/v1,api_key 用你的 sk_live_…。
3. 照常调用:发 chat.completions 请求,响应是标准 OpenAI 形状(含 usage token 统计)。

代码示例

# cURL
curl https://highcadre.com/v1/chat/completions \
  -H "Authorization: Bearer sk_live_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"cadre-chat","messages":[{"role":"user","content":"你好"}]}'

# Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(base_url="https://highcadre.com/v1", api_key="sk_live_你的KEY")
r = client.chat.completions.create(
    model="cadre-chat",
    messages=[{"role": "user", "content": "帮我写条朋友圈文案"}])
print(r.choices[0].message.content)

用量、计量与额度

• 每次 API 调用的 token 与网页用量同口径计入你的租户额度,并出现在「计费与成本」报表里。
• 达到租户 24 小时用量上限会返回 429(insufficient_quota)——费用不会跑飞;需要提额联系管理员。
• 支持 stream 流式;错误按 OpenAI error 形状返回,现成客户端可直接对接。
• 密钥可随时吊销,立即失效;平台只存哈希,泄露风险可控。

适合哪些场景

把平台能力嵌进你自己的产品或流程:客服系统里挂一个答疑接口、内容中台批量生成文案、内部工具接一个"写周报/拆需求"的按钮、或用定时脚本跑固定任务。凡是你已经在用 OpenAI 接口的地方,几乎都能平滑切过来。

一句话:网页给业务同事用,API 给你的程序用,两边共用同一套计量、额度与审计。改两行配置就能开始——先签一把 key 试试最省事。