用一个请求，
把 100 人 AI 团队装进你的产品

在 个人中心 · 开发者 生成密钥（形如 opc_live_…），放进每个请求的请求头。明文密钥只在生成时展示一次。

Authorization: Bearer opc_live_你的密钥

请求体：brief（必填，4–8000 字的一句话需求）、webhookUrl（可选，必须是 https，任务完成后回调）。

curl -X POST https://opcagent.site/api/v1/tasks \
  -H "Authorization: Bearer opc_live_你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "brief": "帮我写一条小红书种草文案，产品是手冲咖啡壶",
    "webhookUrl": "https://你的域名/hook"
  }'

立即返回 202，任务在后台执行：

HTTP/1.1 202 Accepted
{
  "success": true,
  "data": {
    "taskId": "8f3a…",
    "status": "planning",
    "statusUrl": "https://opcagent.site/api/v1/tasks/8f3a…",
    "webhook": { "configured": true, "status": "pending" },
    "quotaRemaining": 9
  }
}

用同样的 Bearer 鉴权轮询 statusUrl。当 status 变为 done，finalOutput 就是方案 markdown。

{
  "success": true,
  "data": {
    "id": "8f3a…",
    "status": "done",
    "brief": "帮我写一条小红书种草文案…",
    "flow": "general",
    "plan": { "summary": "…", "steps": [ … ] },
    "finalOutput": "# 小红书种草文案\n\n## 标题\n…",
    "createdAt": "2026-06-09T03:00:00.000Z",
    "updatedAt": "2026-06-09T03:02:30.000Z",
    "webhook": { "configured": true, "status": "delivered", "attempts": 1 }
  }
}

配置了 webhookUrl 后，任务结束（task.completed 或 task.failed）会 POST 到你的地址，失败自动重试 3 次。

POST https://你的域名/hook
Headers:
  X-OPC-Event: task.completed
  X-OPC-Signature: sha256=<hmac>

{
  "event": "task.completed",
  "taskId": "8f3a…",
  "status": "done",
  "brief": "帮我写一条小红书种草文案…",
  "flow": "general",
  "finalOutput": "# 小红书种草文案\n\n…",
  "error": null,
  "createdAt": "2026-06-09T03:00:00.000Z",
  "completedAt": "2026-06-09T03:02:30.000Z"
}

用你那把密钥的「Webhook 签名密钥」（whsec_…）校验 X-OPC-Signature，确认回调来自百人公司：

import crypto from "node:crypto";

// Express 示例：用你的 Webhook 签名密钥校验回调真伪
app.post("/hook", express.raw({ type: "application/json" }), (req, res) => {
  const sig = req.headers["x-opc-signature"];
  const expected =
    "sha256=" +
    crypto.createHmac("sha256", process.env.OPC_WEBHOOK_SECRET)
      .update(req.body) // 原始 body buffer
      .digest("hex");
  if (sig !== expected) return res.status(401).end();

  const event = JSON.parse(req.body.toString());
  // event.status === "done" → event.finalOutput 就是方案 markdown
  res.json({ ok: true });
});

配额说明：API 调用与网页端共用同一份任务配额（免费每月 10 次 + 邀请奖励 + 已购套餐）。配额不足时返回 402 + code: QUOTA_EXHAUSTED。