AI 어드바이저 (스트리밍)

AI 어드바이저 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" }
    }
  }
}