generate

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

shader*string

a wave interference pattern made by layering similar patterns on top of each other.

Value in

"moire"
"concentric-shapes"

template?TemplateId

Known template id whose aspect ratio and dimensions are applied to the output. Defaults to common:portrait when omitted.

Value in

"common:landscape"
"common:portrait"
"common:square"
"instagram:feed:square"
"instagram:feed:portrait"
"instagram:feed:landscape"
"instagram:stories"
"instagram:reels"
"instagram:carousel"
"instagram:carousel:tall"
"instagram:avatar"

seed?integer

Deterministic render seed. When supplied, it affects the default values for generation parameters; a random seed is generated and returned when omitted.

Range0 <= value <= 4294967295

colors*array<>

Ordered palette of hex colors driving the gradient and shader output.

Items2 <= items <= 12

contrast?number

Post-processing contrast applied to the render, from 0 (flat) to 1 (maximum).

Range0 <= value <= 1

count?integer

Number of repeated elements the shader draws.

Range1 <= value <= 512

falloff?number

Softness of the falloff between shader elements; higher values blend more.

Range0 <= value <= 64

rotation?number

Rotation applied to the composition, in degrees.

Range-3600 <= value <= 3600

effects?array<||>

Post-processing effects, applied in order as a pipeline. Repeats are allowed.

Itemsitems <= 6

shape?Shape

The shape that repeats across the composition.

Value in

"circle"
"triangle"

Response Body

`application/json`

curl -X POST "https://example.com/generate" \  -H "Content-Type: application/json" \  -d '{    "shader": "moire",    "colors": [      "string",      "string"    ]  }'

{  "success": true,  "result": {    "id": "string",    "url": "string",    "seed": 0,    "generated_at": "string",    "template": "string",    "width": 0,    "height": 0,    "aspect_ratio": "string"  }}

generate

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`