Ad Creative Lab

Role and auth requirements

• Primary roles: OWNER, OPERATOR
• Auth mode: JWT (Authorization: Bearer <token>)

UI flow (draft)

1. Select campaign creative set.
2. Run analysis/fatigue detection.
3. Generate alternatives and review results.

API fallback (draft)

• POST /v2/handles/{handle}/ad-intelligence/creative-analysis
• POST /v2/handles/{handle}/ad-intelligence/fatigue-detect
• POST /v2/handles/{handle}/ad-intelligence/creative-generate

Input validation rules

• Creative generate body must be a JSON object.
• Required fields: productDescription, targetAudience.
• Optional controls: platform, tone, count (clamped to 1..10).

Failure and remediation (draft)

• 400 invalid_json: request body is missing, malformed, or not a JSON object.
• 400 productDescription is required: provide non-empty product details.
• 400 targetAudience is required: provide a non-empty audience segment.
• 401 unauthorized: refresh JWT.
• 422 unprocessable_entity: revise unsupported creative payload shape.
• 503 unavailable: retry after model/runtime recovery.