开始使用 JobsLoop API
从创建 Key 到首次调用
一个招聘者企业账户接入国内模型与招聘能力。选服务、准备余额、发送请求,再到控制台核对用量。
先选择你需要的结果
完成第一条调用
- 创建 Key
创建企业 API Key
开通招聘者账户,在 Key 管理中填写项目名称。密钥仅展示一次,保存到服务器或工作流凭证管理器。
- 查看余额
准备可用余额
API 使用注册赠送余额与充值余额。统一充值,1 元 = 1 积分;资源包、会员与促销额度不抵扣 API。
- 打开调试台
发送一个示例请求
先用不含个人信息的示例验证接入。调试台会显示结果和本次费用。
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。批量招聘任务使用独立异步接口。
重试前先核对记录
不要把部分输出当成完成
为同一业务请求设置 Idempotency-Key,避免重复执行。模型回答正文不持久化,已完成模型请求再次使用同一键返回 409,不重放正文;请在客户端保存结果。招聘接口按各自说明回放可保存的数据。
发生 settlement_state_unknown、连接中断或收到部分内容时,先用请求编号核对账单。不要自动换新键重复调用。
遇到错误时
| 状态 | 下一步 |
|---|---|
| 400 / 413 | 检查模型 ID、参数格式、请求大小。 |
| 401 / 403 | 检查密钥是否有效、账户与权限是否符合要求。 |
| 402 | 充值,或降低模型最大输出上限。 |
| 409 | 核对同一幂等键对应的请求状态。 |
| 429 | 等待当前请求完成,检查项目额度。 |
| 502 / 503 / 504 | 检查请求记录,再决定是否重试或联系支持。 |
