Collections

Collection allows you to create multiple images from multiple templates within a single request

Use cases

Generally, there are two use cases of collection,
  1. 1.
    To create images from multiple similar templates in a collection.
    Image if you have a similar template but with different dimension. For example, you could have three templates - one for Instagram post, one for Pinterest, and one for open graph.
  2. 2.
    To create image from randomly selected template in a collection.
    If you have multiple templates with similar content but with different design, you might want to generate an image randomly from the collection of templates. This is useful if you want to create Instagram post but you don't want the design to be the same.

How to create template collection

Before you can send a request to collection endpoint, you need to create the collection first.
  1. 1.
    Go to "Collections" tab and click on "+ New Collection"
2. Add the template that you want to add into the collection and save your changes.

Templates Compatibility

For best compatibility, each template's fields must have similar types. i.e. a field named text_1 must be of type textbox in all the templates.

Endpoints

Collection endpoint only available in asynchronous mode.
post
https://api.usestencil.com
/v1/collections
Create images from a template collection
get
https://api.usestencil.com
/v1/collections/:id
Retrieve images from template collection
Last modified 1yr ago