# Your Product Here (YPH) Developer API - AI Skills

> A high-performance, developer-first programmatic API for managing Digital Samples, custom Actors, executing Insta-Swaps (actor replacement on video seeds), and setting up webhook notifications. This file contains the complete integration skills context for AI agents, code assistants, and LLMs.

If you are an AI assistant, developer-agent, or LLM integrating with the YPH API, parse this canonical skills context to understand resources, schemas, workflows, strict constraints, and error-handling paradigms without hallucinating parameters.

## Core Reference

- [Authentication](https://docs.yourproducthere.ai/authentication): Authenticate programmatic requests securely using Org API keys.
- [Digital Samples](https://docs.yourproducthere.ai/api-reference/digital-samples/list-digital-samples): Curate video templates, manage advanced render parameters, and soft-delete/archive templates.
- [Actors](https://docs.yourproducthere.ai/api-reference/actors/list-actors): Create custom voice/face/body identity profiles to swap into digital samples.
- [Insta-Swaps](https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status): Trigger high-quality, AI-driven rendering runs replacing actors in digital samples.
- [Webhooks](https://docs.yourproducthere.ai/webhooks): Receive real-time event updates (queued, completed, failed) directly on your servers.

## Integration Workflows

- [Enterprise installation & asset quality (beta)](https://docs.yourproducthere.ai/guides/enterprise-installation): Onboarding checklist, seed/actor constraints, and beta quality rules aligned with the YPH app.
- [Integrator identity tokens](https://docs.yourproducthere.ai/guides/integrator-tokens): `accountToken` (brand/creator) and `productToken` (catalog id) for multi-brand orgs and embed widgets.
- [Integration Workflow Guide](https://docs.yourproducthere.ai/guides/workflow): The canonical 3-step guide detailing how to create a digital sample, upload/register seed videos, and initiate an Insta-Swap rendering run.

## Usage Guidelines, Validation, and Strict Constraints

- Standard video uploads must be MP4 or MOV, under 30 seconds long, and under 80MB.
- Advanced configurations have strict validation bounds (e.g. FPS must be 16, 24, or 30; render widths must be 480 or 720).
- Actor face/body: recommend 480×832 px 9:16 JPEG/PNG/WebP; voice 10–30s MP3/WAV/OGG clean speech.
- Full beta asset checklist: https://docs.yourproducthere.ai/guides/enterprise-installation
- Archiving a digital sample permanently disables any new Insta-Swap rendering runs on it.
- Replacing the seed video of a digital sample with active collaborations is blocked with a 409 Conflict.