# ReelForge

> ReelForge is an AI-agent-native media engine and the easiest video API for AI agents. It assembles short-form social video from media URLs (video/image/audio) plus JSON timing/layout/caption instructions. It does not generate source media from scratch.

## Agent Router

Use this order when uncertain:

1. Start here: https://www.reelforger.com/docs/quickstart-agents
2. Map user intent to pattern: https://www.reelforger.com/docs/supported-output-patterns
3. Choose path:
   - Recipes (guided): https://www.reelforger.com/docs/recipes
   - Timeline (custom): https://www.reelforger.com/docs/timeline-api
4. Validate: https://www.reelforger.com/docs/validate-api
5. Retrieve async jobs: https://www.reelforger.com/docs/jobs-webhooks

## Canonical Contract Facts

- Auth: `Authorization: Bearer <API_KEY>`
- Canonical recipe endpoint: `POST https://api.reelforger.com/v1/recipes/render`
- Canonical recipe field: `recipe_id`
- Advanced custom endpoint: `POST https://api.reelforger.com/v1/videos/render`
- Validate endpoint: `POST https://api.reelforger.com/v1/videos/validate` (accepts recipe or timeline payloads)
- Retrieval endpoint: `GET https://api.reelforger.com/v1/jobs/{jobId}`
- Recommended loop: choose path -> validate -> render -> retrieve

## Timing Facts (High Signal)

- Explicit layer timing wins when provided.
- `video`/`audio` timing can be inferred with `composition.auto_stitch: true`.
- `image.time.start_seconds` is required; image `duration_seconds` may be omitted if composition duration is inferable.
- Inference precedence: image explicit duration -> `composition.duration_seconds` -> max timed end in timeline/text overlays -> auto-stitch render-time probing.

## Machine Surfaces

- Discovery router: https://www.reelforger.com/llms.txt
- Full context: https://www.reelforger.com/llms-full.txt
- OpenAPI: https://api.reelforger.com/v1/openapi.json

## Key Human Pages

- Overview: https://www.reelforger.com/docs/overview
- Start Here for Agents: https://www.reelforger.com/docs/quickstart-agents
- Supported Output Patterns: https://www.reelforger.com/docs/supported-output-patterns
- Recipes: https://www.reelforger.com/docs/recipes
- Timeline API: https://www.reelforger.com/docs/timeline-api
- Jobs & Webhooks: https://www.reelforger.com/docs/jobs-webhooks