企业模型 API

一把 Key，连接国内模型与招聘能力

使用当前企业账户充值，在服务器或工作流中保存 Key。无需分别注册和充值多家模型平台。

开始接入

  1. 开通企业招聘者账户，在充值页面增加余额。
  2. 进入API Key 管理，填写项目名称并创建 Key。
  3. 在模型中心复制模型 ID，设置请求限额并查看用量。

密钥仅保存在可信执行环境

不要把 Key 写入前端网页、公开表格或 Git 仓库。工作流平台应使用凭证变量，示例中的环境变量由部署人员设置。

模型列表与价格

读取模型目录
curl https://api2.jobsloop.cn/api/open/v1/models \
  -H "Authorization: Bearer $JOBSLOOP_API_KEY"

返回包含模型 ID、服务商、可用状态和按输入长度分档的价格。标记已配置服务不代表实时健康检测。仅模型目录中的模型可调用；海外模型及任意自定义上游均不支持。

发送模型请求

Python：使用同一把 Key 切换模型
import os
import requests

response = requests.post(
    "https://api2.jobsloop.cn/api/open/v1/chat/completions",
    headers={"Authorization": "Bearer " + os.environ["JOBSLOOP_API_KEY"]},
    json={
        "model": "deepseek-v4-flash",
        "messages": [{"role": "user", "content": "列出招聘计划需要确认的三个问题"}],
        "max_tokens": 1024,
        "stream": False,
    },
    timeout=330,
)
response.raise_for_status()
result = response.json()
print(result["choices"][0]["message"]["content"])
print(result["usage"], result["billing"])

兼容 Chat Completions 的文本消息和函数工具调用格式。Base URL 为 https://api2.jobsloop.cn/api/open/v1。当前不支持 Responses、图像输入、任意透传参数或平台代执行函数。

messages 最多 64 条；请求体不超过 128 KiB；max_tokens 为 1–16384，默认 4096；stream 默认 true。工具调用后，由客户程序执行工具，并补齐带对应 tool_call_id 的结果消息。DeepSeek 思考模式继续对话时应保留 reasoning_content。

流式返回与结算

流式调用
curl -N https://api2.jobsloop.cn/api/open/v1/chat/completions \
  -H "Authorization: Bearer $JOBSLOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"列出岗位需求确认事项"}],"max_tokens":1024,"stream":true}'

SSE 的 data: 事件返回内容增量；以冒号开头的心跳帧应忽略。最终完成帧包含 usage、billing 和 request_id，随后发送 [DONE]。流式开始后发生错误时，HTTP 状态可能已是 200，客户端仍须检查事件内的 error。

按上游实际用量结算，缓存命中按目录价格计算，单次合计向上取整到 0.01 元。API 优先扣注册赠送余额，再扣充值余额；会员、资源包与促销额度不抵扣。请求前按输入及最大输出检查余额，不预扣、不冻结。

每个企业账户当前同时执行 1 个模型请求，跨 Key 共享并发限制；日/月请求限额为滚动 24 小时/30 天。模型请求最长 5 分钟，120 秒无上游数据中断。失败、断流或缺少完整用量时不扣费；完成并结算后客户端丢失连接，仍可能存在费用，应核对调用记录。

重试与错误处理

可发送 Idempotency-Key 防止同一请求重复执行。模型回答正文不持久化，已完成请求再次使用同一个键会返回 409，不重放正文、不重复扣费。请在客户端保存结果；不要在收到部分输出后自动用新键重试。

状态处理方式
400核对模型 ID、消息和支持的参数。
401 / 403检查企业 Key 是否有效及有相应权限。
402充值，或降低 max_tokens 后重试。
409同一幂等键已完成或执行中，先核对结果与用量。
429等待正在运行的请求结束，或检查项目请求限额。
502 / 503 / 504供应商或连接异常，先核对是否收到完成事件和账单。

把招聘能力接入现有工作流

以 Dify 的 HTTP 请求节点为例：创建两个文本输入变量 resumeText 和 jdText，请求方法选 POST，地址填写 https://api2.jobsloop.cn/api/open/v1/matches/resume-jd。请求头设置 Content-Type 为 application/json，Authorization 从凭证变量读取 Bearer Key。

HTTP 节点 JSON 请求体（将值绑定为流程输入变量）
{
  "resumeText": "绑定已获授权的简历文本变量",
  "jdText": "绑定岗位要求变量"
}

将接口返回的 data 交给下一个表格或人工审核节点，billing.billed_points 用于展示本次费用。请使用工作流的 JSON 字段映射，不要直接拼接未经转义的文本。现有人岗匹配每次 1 积分；其他招聘接口见招聘 API 文档。这是配置步骤，当前不提供自动安装到第三方平台的连接器。

没有技术人员，也可以直接使用 JobsLoop 招聘工作台。招聘结果供人工判断参考，不应作为自动淘汰候选人的唯一依据。

数据与服务范围

请求会送往目录所列国内模型供应商。数据处理、留存和服务地域以合同与供应商协议为准。模型 API 流水保存请求编号、模型、用量、费用与状态，不保存请求和回答正文。招聘业务接口的数据规则另见对应文档。

海外模型暂不开放自助调用。其他模型或更高并发需求可联系销售评估，联系销售不代表已获准接入。