开发者中心

净业 AI API 文档

使用统一的 /api/jobs 接口即可调用抠图、证件照、去水印、打印增强等能力，支持同步或异步返回。

联系获取 API Key

统一接口

POST /api/jobs，根据 serviceId 区分能力，metadata 用于附加模板参数。

结果格式

返回 result.result 或 result.urls，优先使用 base64，没有则回落到 URL。

常用服务 ID

print_ai、id_photo_ai、watermark_ai、cutout_ai 等，可按需扩展。

回调/轮询

默认同步，如需异步可在 metadata 中传入回调地址或定时轮询任务状态。

cURL 示例

curl -X POST https://jingye.ai/api/jobs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
    "serviceId": "print_ai",
    "imageBase64": "<BASE64_IMAGE>",
    "metadata": {
      "preset": "standard",
      "prompt": "扫描件自动矫正，去阴影，去黑底"
    }
  }'

JavaScript fetch 示例

async function requestJob() {
  const res = await fetch("https://jingye.ai/api/jobs", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.NEXT_PUBLIC_API_KEY}`,
    },
    body: JSON.stringify({
      serviceId: "id_photo_ai",
      imageBase64: "<BASE64_STRING>",
      metadata: {
        presetId: "standard",
        prompt: "专业证件照，纯白背景，去掉眼镜",
      },
    }),
  });

  const payload = await res.json();
  if (!payload.success) throw new Error(payload.error);
  return payload.result?.result ?? payload.result?.urls?.[0];
}