API 参考

AI 顾问（流式）

通过流式聊天获取关于您项目的专家建议 — SEO、设计、可访问性、性能。

最后更新： 2026年5月28日

AI Advisor API

以流式方式获取涵盖 SEO、设计、性能、无障碍性、文案撰写、架构、营销和安全等方面的专家项目建议。每次 POST 消耗CREDIT_COSTS.ADVISOR 个积分，每个 API 密钥每小时限速 20 次请求。管理员免除积分扣除。

获取顾问历史记录

GET /api/v1/projects/{projectId}/advisor

返回项目的顾问对话按时间顺序排列的历史记录。

{
  "data": {
    "history": [
      { "id": "msg_...", "role": "user", "content": "Audit my SEO" },
      { "id": "msg_...", "role": "assistant", "content": "## SEO Audit..." }
    ]
  }
}

咨询顾问（流式）

POST /api/v1/projects/{projectId}/advisor
Content-Type: application/json

{ "message": "Audit my homepage for accessibility issues" }

返回 text/plain 流。速率限制响应头在第一个数据块之前发送，以便客户端可提前解析。超过 5000 个字符的消息将被拒绝，并返回 VALIDATION_ERROR。

curl -N -X POST https://floop.tech/api/v1/projects/PRJ123/advisor \
  -H "Authorization: Bearer flp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"message":"Review my copy"}'

积分不足时，API 返回结构化的 403 错误，以便工具调用客户端能够精确显示缺口：

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "limit": {
      "blocked": true,
      "reason": "credit_limit",
      "required": 1,
      "available": 0,
      "cta": { "text": "Buy credits", "action": "buy_credits" }
    }
  }
}