image-processor-guidelines

FastAPI image processors validate faces using MediaPipe FaceMesh by configuring detection routes under /v1, implementing Pydantic v2 models for request validation, and integrating MediaPipe's face landmark detection. The Skill provides structured patterns for routes, dependencies, and error handling to ensure robust validation.

Integrate Perfect Corp API by implementing mock and real modes in FastAPI routes, handling provider normalization, configuring structured logging with correlation headers (X-Request-Id, X-Analysis-Session, X-Frame-Seq), and applying CIDR plus X-Internal-Secret access control. The Skill covers best practices for error handling and request tracing.

Structured logging in FastAPI correlates requests using headers like X-Request-Id and X-Analysis-Session, logging each frame sequence with X-Frame-Seq. The Skill provides guidelines for middleware configuration, dependency injection, and logging patterns that maintain request context across microservice calls.

Yes. FastAPI access control combines CIDR validation (checking client IP ranges) with X-Internal-Secret header verification in middleware or route dependencies. The Skill details configuration patterns for both authentication methods and their implementation within FastAPI's dependency system.

Testing strategies include mock mode for Perfect Corp integration, unit tests for Pydantic model validation, and integration tests for MediaPipe face detection. Deployment follows versioned route patterns (/v1) and structured logging. The Skill covers testing approaches and production deployment checklist items.

Use mock mode during development and testing to avoid Perfect Corp API costs and latency; switch to real mode for production. Mock mode returns synthetic responses while real mode processes actual image data. The Skill guides configuration management and mode switching for different deployment environments.