Skip to main content
POST
/
api
/
generate
Create a generation
curl --request POST \
  --url https://airgraphic.io/api/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceUrl": "<string>",
  "sourceText": "<string>",
  "sourceImage": "<string>"
}
'
{
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "stages": [
    "<string>"
  ],
  "falRequestId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.airgraphic.io/llms.txt

Use this file to discover all available pages before exploring further.

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
​
falRequestId
string