Contentdrips icon

Contentdrips

Create designs, carousels, graphics, and social posts with the Contentdrips API

Actions20

Carousel → Generate

AI-generated

Summary

Generate a carousel design based on a specified template ID, filling it with provided content and optional branding, and output the resultant design in PNG or PDF format.

Inputs

  • Template ID (required) — The ID of the template to use for rendering the carousel.
  • Profile ID — Optional workspace/profile ID to identify the context; the API can infer this from your token if omitted.
  • Output Format — Choose between PNG or PDF format for the generated carousel output.
  • Include Branding — Toggle to include branding information in the output.
  • Branding — If branding is included, provide details like name, handle, bio, website URL, and avatar image URL.
  • Content Updates Input — Select how to provide content updates: via simple form inputs or advanced JSON.
  • Content Updates — When using form mode, specify an array of updates, each detailing the type (textbox or image), label, and new value for carousel elements.
  • Content Updates JSON — When using JSON mode, provide content updates as a JSON array with objects containing type, label, and value for each element to update.
  • Carousel Format — Choose the payload format of the carousel content: Legacy (simple heading/description/image per slide) or New (elements map keyed by template labels).
  • Carousel Input — Select whether to input carousel slide data using form entries or JSON.
  • Intro Slide — When using Legacy format and form input, specify heading, description, and image URL for the intro slide.
  • Slides — When using Legacy format and form input, provide an array of slides each with heading, description, and image URL.
  • Ending Slide — When using Legacy format and form input, specify heading, description, and image URL for the ending slide.
  • Carousel JSON — When using Legacy format and JSON input, provide complete carousel data as JSON including intro_slide, slides array, and ending_slide.
  • Carousel Topic — When using New format and form input, optionally specify a topic or theme for the carousel.
  • Intro Slide Elements — When using New format and form input, define multiple intro slide elements by label, type (text or image), value, and optional Unsplash image query.
  • Content Slides — When using New format and form input, provide one or more slides each represented as an elements map keyed by template labels.
  • Ending Slide Elements — When using New format and form input, specify ending slide elements similarly keyed and typed like other slides.
  • Carousel Content JSON — When using New format and JSON input, provide the full carousel content structure with intro_slide, slides, and ending_slide element maps as JSON.

Output shape

a single JSON object per input item

Returns the generated carousel design data including metadata and a link or embedded output in the chosen format (PNG or PDF). The output includes success or error details tied to the input item. Errors are returned in JSON with an error message if 'continue on fail' is enabled.

Examples

Example 1: Generate a simple PNG carousel using Legacy format with form input and no branding

Set Template ID, choose output as PNG, input legacy formatted slides via form, leave branding disabled.

Example 2: Generate a PDF carousel using New format with JSON input including branding

Set Template ID and output format to PDF, enable branding with name and avatar URL, provide full carousel_content JSON to define the carousel.

Links

Discussion