Skip to main content
The OpenAPI reference is generated from the checked-in openapi.json file.

Authentication

Use a bearer API key created in /app/api-keys.
API keys inherit the workspace plan, credits, saved brands, and rate limits. Revoked keys return 401.

Endpoints

POST /api/generate

Queues one infographic generation and returns 202 with a jobId. Supported JSON primary sources:
  • sourceUrl
  • sourceText
  • sourceImage data URI
Supported multipart primary source fields:
  • sourcePdf
  • sourcePptx
  • sourceImage
referenceImage is separate. It guides visual style or asset use but does not count as the source material.

POST /api/meme

Queues one researched meme generation and returns 202 with a jobId after culture scouting, template matching, and creative selection. Memes cost 2 credits. Supported JSON primary sources:
  • sourceUrl
  • sourceText
  • sourceImage data URI
Supported multipart primary source fields:
  • sourcePdf
  • sourcePptx
  • sourceImage
Optional hints:
  • brandUrl
  • brandProfileId
  • audienceNote
  • avoidNote
  • styleNotes
  • aspectRatio (1:1, 4:5, 9:16, 16:9)
  • outputFormat

GET /api/jobs/{id}

Returns the latest job state. Completed jobs include imageUrl.

Rate limits

Rate-limited responses include x-ratelimit-limit, x-ratelimit-remaining, and x-ratelimit-reset headers.