Skip to main content
POST
Create a generation

Authorizations

Authorization
string
header
default:ag_your_api_key
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

sourceUrl
string<uri>
required
sourceText
string
Maximum string length: 8000
sourceImage
string

PNG, JPG, or WebP data URI used as the primary source.

brandUrl
string<uri>
aspectRatio
enum<string>
default:9:16
Available options:
9:16,
1:1,
4:5,
16:9
outputFormat
enum<string>
default:png
Available options:
png,
jpeg,
webp
fontName
string
Maximum string length: 80
fontCssUrl
string<uri>
styleNotes
string
Maximum string length: 800
enableCritique
boolean
default:false
referenceImage
string

Optional http(s) image URL or data URI for visual style or asset guidance.

referenceNote
string
Maximum string length: 500
brandProfileId
string<uuid>
outcome
enum<string>
Available options:
linkedin_carousel_slide,
linkedin_post,
instagram_post,
story_reel,
blog_header,
custom

Response

Generation queued.

jobId
string<uuid>
required
status
enum<string>
required
Available options:
queued
stages
string[]
required