AI アドバイザー（ストリーミング）

AI Advisor API

SEO、デザイン、パフォーマンス、アクセシビリティ、コピーライティング、アーキテクチャ、マーケティング、セキュリティにわたる専門的なプロジェクトアドバイスをストリームします。 各 POST は CREDIT_COSTS.ADVISOR クレジットを消費し、API キーごとに 1 時間あたり 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" }
    }
  }
}