开始使用 JobsLoop API

从创建 Key 到首次调用

一个招聘者企业账户接入国内模型与招聘能力。选服务、准备余额、发送请求,再到控制台核对用量。

先选择你需要的结果

完成第一条调用

  1. 创建企业 API Key

    开通招聘者账户,在 Key 管理中填写项目名称。密钥仅展示一次,保存到服务器或工作流凭证管理器。

    创建 Key
  2. 准备可用余额

    API 使用注册赠送余额与充值余额。统一充值,1 元 = 1 积分;资源包、会员与促销额度不抵扣 API。

    查看余额
  3. 发送一个示例请求

    先用不含个人信息的示例验证接入。调试台会显示结果和本次费用。

    打开调试台
curl
curl 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
}'

统一接口与密钥

模型兼容接口 Base URL:https://api2.jobsloop.cn/api/open/v1。每个请求发送 Authorization: Bearer YOUR_API_KEY。同一 Key 可用于模型、招聘 REST 接口与 MCP 招聘工具,不能用网站登录 Token 替代。

按不同项目创建 Key,独立设置请求额度;费用归属于创建 Key 的招聘者账户。API Key 不应出现在公开代码、网页脚本、日志或客服消息中。

如何看价格与扣费

模型按输入、输出和缓存命中实际 Token 结算,按长度分档的价格在模型目录展示,单次合计向上取整到 0.01 积分。招聘能力按对应接口价格收费,例如人岗匹配每次 1 积分、简历解析每页 0.05 积分。

模型完成帧的 billing.billed_points 是本次扣费。旧招聘接口的 balance_points 表示本次从钱包扣除的金额,不是剩余余额。剩余余额请在企业控制台查看。

查看用量与请求详情

控制调用节奏

当前模型 API 每账户并发 1,跨项目 Key 共享并发限制。项目请求上限按滚动 24 小时和 30 天统计,可在 Key 管理中调整。超限返回 429;余额不足返回 402。

模型支持文本与函数工具调用,暂不支持图像或任意上游参数。请求体上限 128 KiB,最多 64 条消息,输出上限 16384 Token。批量招聘任务使用独立异步接口。

重试前先核对记录

不要把部分输出当成完成

模型流式响应必须检查最终 billing 或 error 事件。HTTP 200 或收到一段文本,都不代表已成功结算。

为同一业务请求设置 Idempotency-Key,避免重复执行。模型回答正文不持久化,已完成模型请求再次使用同一键返回 409,不重放正文;请在客户端保存结果。招聘接口按各自说明回放可保存的数据。

发生 settlement_state_unknown、连接中断或收到部分内容时,先用请求编号核对账单。不要自动换新键重复调用。

遇到错误时

状态下一步
400 / 413检查模型 ID、参数格式、请求大小。
401 / 403检查密钥是否有效、账户与权限是否符合要求。
402充值,或降低模型最大输出上限。
409核对同一幂等键对应的请求状态。
429等待当前请求完成,检查项目额度。
502 / 503 / 504检查请求记录,再决定是否重试或联系支持。

更多参数和示例见接口参考,工作流配置见招聘工作流示例。海外模型不提供自助调用,专项需求可联系企业顾问评估。