> ## Documentation Index > Fetch the complete documentation index at: https://docs.kynva.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create slideshow > Generate a slideshow animation from multiple templates with 34 transition types and 7 loop modes ## OpenAPI ````yaml /openapi.yaml post /api/v1/animations/slideshow openapi: 3.0.0 info: title: Kynva Public API description: > # Kynva Public API v4.0 The stateless contract API: everything flows through `POST /api/v1/facade/generate` with a `RenderForgeRequestV1` body. ## Entry Points ### Sync preview ``` POST /generate { operation: "preview" } → 200 with rendered outputs ``` ### Async render ``` POST /generate { operation: "render" } → 202 + job → poll GET /render-jobs/{id} or subscribe to webhooks ``` ### Signed image URLs (the OG-image primitive) ``` POST /api/v1/generate/sign → signed GET URLs → 302 to immutable rendered PNGs ``` ## Core Principle Deterministic by construction: the same request, engine version, and seed produce byte-identical output. ## API Versioning Include `X-API-Version: 2026-01-01` in all requests. ## Authentication Include `Authorization: Bearer ` in all requests (signed image GET URLs authenticate by signature instead). ## Idempotency Include `Idempotency-Key: ` for all POST/PATCH mutations. ## Rate Limiting Tiered limits per endpoint category (see documentation). version: 4.0.0 contact: name: Kynva Support url: https://github.com/fredadun/renderforge license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.kynva.ai description: Production - url: https://renderforge-production-838f.up.railway.app description: Production (direct, until api.kynva.ai DNS lands) - url: http://localhost:3000 description: Development security: - bearerAuth: [] tags: - name: Brands description: Brand management - name: BrandKits description: Brand kit version management - name: Assets description: Asset upload and management - name: Drafts description: Draft creation and workflow - name: Decisions description: Decision records and explainability - name: Render Jobs description: Async render job management - name: Webhooks description: Webhook configuration and DLQ - name: Render Now description: Single-call convenience endpoint - name: Templates (Advanced) description: Template selection and listing - name: Validation (Advanced) description: Stateless validation - name: Compile (Advanced) description: Stateless compilation - name: Licenses (Advanced) description: License checking - name: Spec Render (Advanced) description: Direct spec preview/render - name: Reference description: Reference data (export profiles, API versions) - name: System description: Health checks and system info - name: Images description: Generate images from templates - name: Templates description: Manage reusable templates - name: Health description: Service health and status paths: /api/v1/animations/slideshow: post: tags: - Animation summary: Create slideshow description: >- Generate a slideshow animation from multiple templates with 34 transition types and 7 loop modes requestBody: content: application/json: schema: type: object required: - frames properties: frames: type: array minItems: 1 maxItems: 20 items: type: object required: - templateId - duration properties: templateId: type: string modifications: type: array stylePreset: type: string description: Style preset ID to apply creativity effects duration: type: number minimum: 100 maximum: 10000 description: Duration in milliseconds transition: type: string enum: - none - fade - dissolve - crossfade - slideLeft - slideRight - slideUp - slideDown - push - reveal - cover - zoomIn - zoomOut - zoomThrough - morph - glitchCut - inkBleed - shatter - liquidWipe - pageTurn - splitReveal - particleDissolve - lightLeak - whipPan - iris - irisOut - pixelate - ripple - wipeLeft - wipeRight - wipeUp - wipeDown - clock - blinds default: none description: >- 34 transition types available. Use GET /api/v1/capabilities/transitions for details. transitionDuration: type: number minimum: 100 maximum: 2000 description: >- Transition duration in ms. If not specified, uses recommended duration for the transition type. fps: type: number minimum: 5 maximum: 30 default: 10 loop: oneOf: - type: boolean - type: string enum: - none - loop - seamless - boomerang - pingPong - infiniteZoom - cinemagraph default: true description: >- Loop mode. Boolean for simple loop, or string for advanced loop types. Use GET /api/v1/capabilities/loops for details. loopConfig: type: object description: Advanced loop configuration properties: count: type: number minimum: 0 description: Loop count (0 = infinite, GIF only) transitionFrames: type: number minimum: 1 description: Frames to use for seamless blending easing: type: string enum: - linear - ease - ease-in - ease-out - ease-in-out description: Easing for pingPong mode holdTime: type: number minimum: 0 description: Hold time at loop point (ms) format: type: string enum: - gif - mp4 default: gif width: type: number minimum: 100 maximum: 2048 height: type: number minimum: 100 maximum: 2048 required: true responses: '200': description: Animation generated successfully content: application/json: schema: description: Animation generated successfully type: object properties: success: type: boolean data: type: object properties: url: type: string width: type: number height: type: number duration: type: number frameCount: type: number format: type: string transition: type: string loopType: type: string components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Your Kynva API key (kyn_live_xxx or kyn_test_xxx; legacy rf_ keys remain valid) ````