Content Generator - Articles, Social Posts, Videos & Images from Any Topic or URL

GenerateBot Core - Search, Generate & Manage Content#

Base URL: https://generatebot.com/api/v1

Authentication: Bearer token in the Authorization header.

text

Authorization: Bearer GENERATEBOT_API_KEY

All request and response bodies use JSON. Set Content-Type: application/json.

---

Quick Reference#

ActionEndpointCreditsTypeSearch contentPOST /agents/news-aggregator10syncFetch RSS feedsPOST /rss0syncManage RSS feedsGET/PUT/DELETE /rss0syncGenerate from URLPOST /pipelines (content-analyzer)100asyncGenerate from topicPOST /pipelines (topic-to-content)100asyncGenerate scriptsPOST /pipelines (script-generator)15asyncPoll statusGET /pipelines/{runId}0pollList runsGET /pipelines0syncSave contentPOST /content0syncList contentGET /content0syncGet/Update/DeleteGET/PATCH/DELETE /content/{id}0syncCheck creditsGET /credits0syncCredit transactionsGET /credits/transactions0sync

---

1. Search for Content Ideas#

POST /api/v1/agents/news-aggregator (10 credits)

json

{
  "topic": "sustainable architecture trends",
  "category": "technology",
  "searchConfig": {
    "resultLimit": 10,
    "countryCode": "us",
    "freshness": "pw",
    "searchBreadth": "wide",
    "preferredDomains": ["techcrunch.com", "reuters.com"],
    "excludeDomains": ["reddit.com"]
  }
}

• topic (required): What to search for

• category (optional): technology, finance, health, realestate, marketing, etc.

• searchConfig (optional):

  • resultLimit: number of results (default 10)
  • countryCode: "us", "au", "gb", etc.
  • freshness: "pd" (past day), "pw" (past week), "pm" (past month), "py" (past year)
  • searchBreadth: "narrow", "balanced", "wide"
  • preferredDomains / excludeDomains: arrays of domain strings

• Returns: array of articles with url, title, description, source, publishedAt, category

• Use the returned URLs with the pipeline endpoint below

Tip: RSS feeds (below) are a free alternative to the news aggregator.

---

2. RSS Feeds (Free Content Sourcing)#

All RSS operations cost 0 credits.

POST /api/v1/rss - Fetch and parse feeds

json

{
  "feedUrls": ["https://techcrunch.com/feed/", "https://blog.example.com/rss"],
  "maxItemsPerFeed": 10,
  "keywords": ["AI", "marketing"],
  "publishedAfter": "2026-04-01T00:00:00Z"
}

• feedUrls (optional): Direct RSS/Atom feed URLs (max 50)
• urls (optional): Website URLs to auto-discover feeds (max 20)
• useSavedFeeds (optional): If true, includes your saved feed URLs
• maxItemsPerFeed: 1-100
• keywords: Filter items by title + description match (max 20)
• publishedAfter: ISO 8601 date filter
• feedFilter / feedExclude: Include/exclude feeds by pattern
• dedup: Deduplicate items across runs
• skipUnhealthyFeeds: Skip feeds with 5+ consecutive failures
• digest: { "maxDigestItems": 20, "groupByTopic": true } for summarized output
• Must provide at least one of urls, feedUrls, or useSavedFeeds
• Returns: feeds array with items (title, link, description, publishedAt, source, etc.)

GET /api/v1/rss - List saved feed URLs

• Returns: { "feedUrls": [...], "count": 3 }

PUT /api/v1/rss - Save feed URLs (requires rss:write scope)

• Input: { "feedUrls": ["https://example.com/feed.xml"] } (max 50)
• Requires an existing business profile

DELETE /api/v1/rss - Clear all saved feed URLs (requires rss:write scope)

---

3. Generating Content (Pipelines)#

POST /api/v1/pipelines (async)

Pipeline TypeCreditsRequiresPurposecontent-analyzer100urlGenerate articles, social posts, scripts, carousel from a URLfull-pipeline100query or queries[]Generate content from a topic or questionscript-generator15queryGenerate video scripts only

From a URL (most common):

json

{ "pipelineType": "content-analyzer", "url": "https://example.com/article" }

From a topic:

json

{ "pipelineType": "full-pipeline", "query": "How AI is transforming healthcare" }

Optional fields:

• market: "au" or "us"
• resultLimit: 1-100
• businessProfile: object with company context
• carouselTemplate: { "prompt": "...", "username": "..." } (content-analyzer only)

Response: { "pipelineRunId": "uuid", "status": "running", "creditsConsumed": 100, "statusUrl": "/api/v1/pipelines/{runId}" }

Save the pipelineRunId -- you need it later as sourcePipelineRunId when creating videos.

Polling: GET /api/v1/pipelines/{runId} every 10 seconds.

• Status values: "pending" -> "running" -> "completed" | "failed"
• Typical duration: 2-3 minutes. Keep polling up to 5 minutes.

GET /api/v1/pipelines - List pipeline runs

• Query params: ?status=completed&pipelineType=content-analyzer&limit=10&offset=0

---

4. Completed Pipeline Response Shape#

When status is "completed", the response contains all generated content:

json

{
  "status": "completed",
  "results": {
    "data": {
      "agents": {
        "aiContentGenerator": {
          "generatedContent": {
            "articles": [{ "title": "...", "introduction": "...", "sections": [{ "heading": "...", "content": "..." }], "wordCount": 1200 }],
            "linkedInPosts": [{ "intro": "...", "mainContent": "...", "callToAction": "...", "hashtags": ["#AI"] }],
            "instagramPosts": [{ "caption": "...", "hashtags": ["#AI"], "imageTextOverlay": "..." }]
          }
        },
        "scriptGenerator": {
          "scripts": [{
            "hook": "Breaking news you need to know!",
            "platform": "tiktok",
            "mainContent": [
              { "scene": 1, "voiceOver": "Here is what happened...", "textOverlay": "Key Point 1" }
            ],
            "callToAction": "Follow for more!",
            "hashtags": ["#News"]
          }]
        },
        "imageFinder": {
          "foundImages": [
            { "imageUrl": "https://cdn.example.com/img1.jpg", "altText": "...", "suggestedUse": "hero" },
            { "imageUrl": "https://cdn.example.com/img2.jpg", "altText": "...", "suggestedUse": "supporting" }
          ]
        },
        "carouselGenerator": {
          "carousel": {
            "slides": [
              { "slideNumber": 1, "text": "Key takeaway from the article" },
              { "slideNumber": 2, "text": "Supporting point with context" },
              { "slideNumber": 3, "text": "Final thought and call to action" }
            ]
          }
        }
      }
    },
    "totalImagesFound": 30,
    "totalContentItems": 5
  }
}

Key paths to extract:

• Articles: results.data.agents.aiContentGenerator.generatedContent.articles[0]
• Scripts: results.data.agents.scriptGenerator.scripts[0]
• Images: results.data.agents.imageFinder.foundImages
• Carousel slides: results.data.agents.carouselGenerator.carousel.slides

IMPORTANT: Pipeline results are NOT auto-saved. Save via POST /content before publishing.

---

5. Content Library#

POST /api/v1/content - Save content (required before CMS/social publishing)

json

{
  "contentType": "article",
  "title": "Article Title",
  "contentData": {
    "introduction": "Intro paragraph...",
    "sections": [{ "heading": "Section", "content": "Body text..." }],
    "metaDescription": "Short description"
  },
  "tags": ["ai", "marketing"]
}

• contentType: "article" | "linkedin" | "instagram" | "tiktok" | "script" | "reel"
• contentData: JSON object (max 100KB)
• tags (optional): max 20 strings
• notes (optional): max 2000 chars
• Returns: { "content": { "id": "uuid", ... } } -- save the id as contentId

GET /api/v1/content - List content

• Query params: ?contentType=article&status=draft&limit=10&offset=0&tags=ai,marketing
• Returns: content list with pagination (no full contentData in list view)

GET /api/v1/content/{id} - Get single item with full contentData

PATCH /api/v1/content/{id} - Update (title, contentData, tags, notes, status)

DELETE /api/v1/content/{id} - Delete

---

6. Credits#

GET /api/v1/credits (0 credits) Returns: { "total": 500, "subscription": 400, "oneTime": 100, "adminGranted": 0, "quota": 1000 }

GET /api/v1/credits/transactions (0 credits) - Credit transaction history

• Query params: ?limit=20&offset=0
• Returns: list of credit transactions with amount, type, description, and timestamps

---

Error Handling#

HTTP StatusMeaning401Invalid or missing API key402Insufficient credits429Rate limit exceeded -- wait and retry400Invalid request body -- check error details404Resource not found

All errors: { "error": { "code": "ERROR_CODE", "message": "..." }, "requestId": "..." }

---

Other GenerateBot Skills#

• Video Skill ( generatebot-video): Create video reels from pipeline data. Step-by-step tutorial for slides, image modes, captions, TTS.
• Publish Skill ( generatebot-publish): Post to social media, publish to CMS, enrich articles, brand voice, AI images.
• Templates Skill ( generatebot-templates): Design and render canvas-based post image templates.
• Workflow Skill ( generatebot-workflows): End-to-end workflow examples, credit costs, usage patterns.

---

GenerateBot Video - Create Video Reels#

Base URL: https://generatebot.com/api/v1

Authentication: Bearer token in the Authorization header.

text

Authorization: Bearer GENERATEBOT_API_KEY

All request and response bodies use JSON. Set Content-Type: application/json.

---

Overview#

This skill creates short-form video reels (9:16 portrait, 1080x1920) with AI voiceover from content you have generated.

• Cost: 200 credits per video
• Endpoint: POST /api/v1/videos
• Max concurrent renders: 2 (extra requests return 429)
• Typical render time: 60-180 seconds

---

Prerequisites#

Before creating a video, you need completed pipeline results. Run a content pipeline first (see Core skill):

text

POST /api/v1/pipelines
{ "pipelineType": "content-analyzer", "url": "https://example.com/article" }

Poll until status is "completed", then extract these three things:

1. Carousel slides: results.data.agents.carouselGenerator.carousel.slides json

   [{ "slideNumber": 1, "text": "Key takeaway from the article" }, ...]
   
   

2. Images: results.data.agents.imageFinder.foundImages json

   [{ "imageUrl": "https://...", "altText": "...", "suggestedUse": "hero" }, ...]
   
   

3. Hook: results.data.agents.scriptGenerator.scripts[0].hook json

   "Breaking news you need to know!"
   
   

4. Pipeline Run ID: The pipelineRunId from the pipeline POST response.

---

Step 1: Build Video Slides#

Each carousel slide becomes one video slide. Map them like this:

json

{
  "text": "<carousel slide text>",
  "imageUrl": "<image URL from imageFinder>",
  "highlight": ["key", "words"]
}

Pairing rules:

• Use the suggestedUse: "hero" image for slide 1
• Use remaining images for subsequent slides
• Each slide MUST have a unique imageUrl -- never reuse the same image across slides
• text is max 200 characters

The text field is both the on-screen caption AND the voiceover narration. Write it as spoken language:

• Numbers in words: "25 million dollars" not "$25M"
• Use "A.I." not "AI" (TTS pronounces it better)
• Add ellipsis for dramatic pauses: "And then... everything changed."

---

Step 2: Image Display Modes#

The imageMode field controls how images appear in the 9:16 portrait frame:

ModeBehaviorBest For_(omit)_Auto-detect: landscape (w/h > 1.2) uses overlay, else backgroundMost cases -- recommended"overlay"Image shown as 16:9 PiP inset (top 12%) over blurred/darkened version of itselfLandscape images, real estate, group photos"background"Full-screen cover-crop fills the entire framePortrait images, close-ups"background_with_overlays"Primary image full-bleed + extraImages as PiP insetsMultiple detail shots over a main image

Recommendation: Omit imageMode in most cases. Auto-detection handles landscape vs portrait correctly. Only set it explicitly to override.

---

Step 3: Extra Images and Word-Synced Timing#

Add related images as overlays that appear synced to specific words in the narration:

json

{
  "text": "A stunning property in Brisbane with a resort style pool",
  "imageUrl": "https://cdn.example.com/mansion-exterior.jpg",
  "extraImages": [
    "https://cdn.example.com/mansion-aerial.jpg",
    "https://cdn.example.com/mansion-pool.jpg"
  ],
  "extraImageTimings": [
    { "showAtWordIndex": 2 },
    { "showAtWordIndex": 7 }
  ]
}

How word indexing works: Count words in text starting from 0, split on whitespace. Punctuation stays attached.

For the text above: A(0) stunning(1) property(2) in(3) Brisbane(4) with(5) a(6) resort(7) style(8) pool(9)

• The aerial shot appears at word 2 ("property")
• The pool shot appears at word 7 ("resort")
• Each overlay stays visible until the next one starts or the slide ends

When to use extraImages:

• Landscape images that lose detail when cropped to 9:16
• Multiple angles of the same subject (exterior + pool + interior)
• You CAN reuse the main imageUrl in extraImages for blurred-bg + clear-overlay effect

Limits: Max 5 extra images per slide. If you omit extraImageTimings, overlays distribute evenly (less precise).

---

Step 4: Highlights#

The highlight field is an array of words from text to emphasize visually (rendered in accent color with glow effect):

json

"highlight": ["25 million", "mansion"]

• Pick 1-3 key words or phrases that appear in the text
• Max 10 items
• If omitted, the API auto-generates 2 highlights (prefers numbers and capitalized words)

---

Step 5: Per-Slide Style Overrides (Optional)#

Each slide can override global styles:

FieldTypeRangefontSizenumber12-120fontWeightstring"normal" or "bold"textColorstringhex, e.g. "#FFFFFF"backgroundColorstringhex, e.g. "#000000"textAlignstring"left", "center", "right"textPositionstring"top", "center", "bottom"imageOpacitynumber0-1textWidthPercentnumber10-100imageScalenumber0.1-5 (zoom level)imagePositionXnumberhorizontal offsetimagePositionYnumbervertical offset

Advanced text styling ( textStyle object, all fields optional):

json

{
  "textStyle": {
    "fontFamily": "Inter",
    "letterSpacing": 1.2,
    "lineHeight": 1.4,
    "textTransform": "uppercase",
    "shadow": { "enabled": true, "offsetX": 2, "offsetY": 2, "blur": 4, "color": "#000000" },
    "outline": { "enabled": true, "width": 2, "color": "#000000" },
    "background": { "enabled": true, "color": "#000000", "opacity": 0.7, "paddingX": 12, "paddingY": 8, "borderRadius": 8 },
    "glow": { "enabled": true, "blur": 10, "color": "#75F30F", "intensity": 0.8 }
  }
}

• textTransform: "none", "uppercase", "lowercase", "capitalize"
• shadow: Drop shadow behind text
• outline: Stroke around text characters
• background: Colored box behind text (like a caption box)
• glow: Colored glow effect around text

---

Step 6: Set the Hook#

json

"hook": "<scriptGenerator.scripts[0].hook>"

• Max 200 characters
• This is the opening text shown before slides begin
• No separate script field needed -- the API auto-builds TTS narration from all slide texts

---

Step 7: Configure Global Style (Optional)#

json

"style": {
  "accentColor": "#FF5500",
  "captionStyle": "outlined",
  "captionPosition": "center",
  "fontSize": 48,
  "colorGrade": "cinematic",
  "filmGrain": { "enabled": true, "opacity": 0.025, "fps": 8 }
}

FieldOptionsDefaultaccentColorHex color#75F30FcaptionStyle"default", "outlined", "boxed", "marker""outlined"captionPosition"center", "lower-third", "top""lower-third"fontSize24-9652colorGrade"cinematic", "warm", "cool", "vibrant", "none"nonefilmGrain``{ enabled, opacity (0-0.1), fps (1-30) }disabled

---

Step 8: Configure Voice (Optional)#

FieldDescriptionDefaultvoiceIdElevenLabs voice ID(default Australian male)ttsModel"eleven_v3", "eleven_flash_v2_5", "eleven_multilingual_v2", "eleven_turbo_v2_5""eleven_v3"speedFactor0.5-3.0, post-render speed multiplier1.35

---

Step 9: Assemble and Submit#

POST /api/v1/videos (200 credits)

json

{
  "hook": "$25M mansion hits the market!",
  "slides": [
    {
      "text": "A 25 million dollar mansion in Brisbane is up for grabs.",
      "imageUrl": "https://cdn.example.com/mansion-exterior.jpg",
      "highlight": ["25 million", "mansion"],
      "extraImages": ["https://cdn.example.com/mansion-aerial.jpg"],
      "extraImageTimings": [{ "showAtWordIndex": 4 }]
    },
    {
      "text": "Spanning 1400 square meters with five bedrooms and eight bathrooms.",
      "imageUrl": "https://cdn.example.com/mansion-pool.jpg",
      "highlight": ["1400", "bathrooms"]
    }
  ],
  "sourcePipelineRunId": "<pipelineRunId from pipeline POST>",
  "style": {
    "accentColor": "#75F30F",
    "captionStyle": "outlined",
    "captionPosition": "center"
  }
}

Field constraints:

• hook: 1-200 chars, required
• slides: 1-15 slides, required (4-7 recommended)
• slides[].text: 1-200 chars, required
• slides[].imageUrl: HTTPS URL, required
• slides[].highlight: max 10 items, optional
• slides[].extraImages: max 5 URLs, optional
• watermark: small text in corner, max 100 chars, optional
• watermarkLogoUrl: HTTPS URL to a logo image for the watermark, optional
• watermarkPosition: position string (max 50 chars), optional
• cta: { "text": "Follow for more!", "url": "example.com" }, optional
• sourcePipelineRunId: UUID, strongly recommended -- links video to source content

Response:

json

{
  "jobId": "uuid",
  "contentId": "uuid",
  "status": "queued",
  "creditsConsumed": 200,
  "statusUrl": "/api/v1/videos/{jobId}"
}

---

Step 10: Poll for Completion#

GET /api/v1/videos/{jobId} every 5 seconds.

Status progression: queued -> generating_audio -> rendering -> uploading -> completed

• queued: 10-30s while render worker starts. Normal.
• generating_audio: TTS is being generated. Progress, not a stall.
• rendering: Video frames being composed. Longest phase.
• completed: videoUrl contains the download URL.
• failed: error field contains the error message.

Keep polling up to 5 minutes. Do NOT stop on intermediate statuses. Do NOT report failure until status is "failed" or you have polled the maximum duration.

---

Step 11: Post the Video#

The video response includes a contentId. Use it directly with POST /api/v1/social/post (see Publish skill):

json

{
  "contentId": "<contentId from video response>",
  "platforms": [{
    "accountId": "<from GET /api/v1/social/accounts>",
    "platform": "instagram",
    "contentType": "video",
    "caption": "Check out our latest video!"
  }]
}

---

Render Time Estimates#

SlidesApproximate Time3-560-90 seconds6-1090-150 seconds11-15150-180 seconds

Audio generation adds 10-20 seconds. Upload adds 5-10 seconds.

---

Error Handling#

HTTP StatusMeaning402Insufficient credits (need 200)429Too many concurrent renders (max 2) -- wait and retry400Invalid request body -- check error details

---

Other GenerateBot Skills#

• Core Skill ( generatebot-core): Search for content, run pipelines, manage content library. Required before creating videos.
• Publish Skill ( generatebot-publish): Post completed videos to social media, publish articles to CMS.
• Templates Skill ( generatebot-templates): Design and render canvas-based post image templates.
• Workflow Skill ( generatebot-workflows): End-to-end workflow examples and patterns.

---

GenerateBot Publish - Social Media, CMS & Content Enhancement#

Base URL: https://generatebot.com/api/v1

Authentication: Bearer token in the Authorization header.

text

Authorization: Bearer GENERATEBOT_API_KEY

All request and response bodies use JSON. Set Content-Type: application/json.

---

Quick Reference#

ActionEndpointCreditsList social accountsGET /social/accounts0Post to socialPOST /social/post0Social post historyGET /social/history0List CMS accountsGET /cms/accounts0Publish to CMSPOST /cms/publish0CMS publish historyGET /cms/history0Create templatePOST /templates0List templatesGET /templates0Get/Update/DeleteGET/PATCH/DELETE /templates/{id}0Render templatePOST /templates/{id}/render20Enrich with linksPOST /enrich/internal-links20Enrich with imagesPOST /enrich/images20Brand voice rewritePOST /agents/brand-voice-rewriter5Generate imagesPOST /agents/ai-image-generator10Reddit repliesPOST /agents/reddit-replier10Business profilePOST /agents/business-profile-generator5

---

Prerequisites#

Most publish actions require a contentId:

• For articles: Save via POST /content first (see Core skill). The response id is your contentId.
• For videos: The POST /videos response includes a contentId automatically (see Video skill).

---

1. Post to Social Media (0 credits)#

Step 1: List connected accounts: GET /api/v1/social/accounts Returns: [{ "id": "uuid", "platform": "instagram", "username": "@handle", "isConnected": true }]

Step 2: Post content: POST /api/v1/social/post

json

{
  "contentId": "uuid-of-saved-content",
  "platforms": [
    {
      "accountId": "uuid-from-social-accounts",
      "platform": "instagram",
      "contentType": "video",
      "caption": "Check out our latest video!"
    },
    {
      "accountId": "uuid-linkedin",
      "platform": "linkedin",
      "contentType": "text",
      "text": "Great insights on AI in healthcare..."
    }
  ]
}

• contentId (required): UUID from POST /content or POST /videos
• platforms[].accountId (required): from GET /social/accounts
• platforms[].platform: "instagram", "tiktok", "threads", "linkedin", "youtube"
• platforms[].contentType: "text", "image", "video", "carousel", "multi-image"
• Optional: caption (max 5000), text (max 5000), hashtags (max 30), mediaUrls (max 10), title (max 200)

---

2. Publish to CMS (0 credits)#

Step 1: List connected CMS platforms: GET /api/v1/cms/accounts Returns: [{ "id": "uuid", "platform": "wordpress", "siteUrl": "https://myblog.com", "isConnected": true }]

Step 2: Publish: POST /api/v1/cms/publish

json

{
  "contentId": "uuid-from-post-content",
  "cmsAccountId": "uuid-from-cms-accounts",
  "title": "Article Title",
  "content": "<p>Introduction paragraph...</p><h2>Section Heading</h2><p>Section content...</p>",
  "excerpt": "Short description",
  "featuredImageUrl": "https://cdn.example.com/hero.jpg",
  "status": "published"
}

• contentId (required): UUID from POST /content
• cmsAccountId (required): from GET /cms/accounts
• title: 1-500 chars
• content: HTML string, 1-200,000 chars
• Optional: slug (max 200), excerpt (max 1000), featuredImageUrl, categories (max 10), tags (max 20), status ("draft" | "published"), scheduledAt (ISO 8601)

HTML conversion tip: Wrap introduction in <p> tags, each section as <h2>heading</h2><p>content</p>.

---

3. Enrich Article with Internal Links (20 credits)#

POST /api/v1/enrich/internal-links

json

{
  "article": {
    "title": "Article title",
    "introduction": "Intro text...",
    "sections": [{ "heading": "Section heading", "content": "Section body..." }]
  },
  "businessProfile": {
    "sitemapUrl": "https://example.com/sitemap.xml",
    "websiteUrl": "https://example.com"
  }
}

Returns: enriched article with relevant internal links inserted into the content.

---

4. Enrich Article with Images (20 credits)#

POST /api/v1/enrich/images

json

{
  "article": {
    "title": "Article title",
    "sections": [{ "heading": "Section heading", "content": "Section body..." }]
  },
  "images": [
    { "imageUrl": "https://...", "altText": "Description", "suggestedUse": "hero" }
  ]
}

• suggestedUse: "hero", "supporting", "thumbnail", or "background"
• Returns: article with images matched to appropriate sections

---

5. Rewrite in Brand Voice (5 credits)#

POST /api/v1/agents/brand-voice-rewriter

json

{
  "articles": [{
    "title": "Article Title",
    "introduction": "Article intro...",
    "sections": [{ "heading": "Section heading", "content": "Section body..." }],
    "metaDescription": "Short description"
  }],
  "businessProfile": {
    "companyName": "Acme Corp",
    "brandVoice": "professional",
    "targetAudience": "enterprise CTOs",
    "industryCategory": "technology"
  }
}

Returns: rewritten articles matching the brand voice.

---

6. Generate AI Images (10 credits)#

POST /api/v1/agents/ai-image-generator

json

{
  "prompts": ["Modern office workspace with natural lighting, minimalist design"],
  "style": "natural",
  "size": "1024x1024"
}

• prompts (required): Array of 1-5 strings (min 10 chars each)
• style: "natural" or "vivid" (default: "natural")
• size: "1024x1024", "1536x1024", "1024x1536", "auto"
• quality: "low", "medium", "high"
• useCase: "thumbnail", "instagram", "carousel", "article" (auto-selects best size/quality)
• Returns: { "data": { "images": [{ "imageUrl": "https://cdn.generatebot.com/...", "prompt": "..." }] } }
• Use the imageUrl values directly as slide images when creating video reels

---

7. Generate Reddit Replies (10 credits)#

POST /api/v1/agents/reddit-replier

json

{
  "redditPostUrl": "https://www.reddit.com/r/smallbusiness/comments/abc123/best_tools/"
}

• redditPostUrl (required): Full URL to a Reddit post
• Optional: analysisConfig: { "responseStyle": "professional" | "casual" | "educational" }
• Returns: post analysis with reply suggestions and confidence scores

---

8. Generate Business Profile (5 credits)#

POST /api/v1/agents/business-profile-generator

json

{
  "websiteUrl": "https://example.com",
  "companyName": "Example Corp"
}

• websiteUrl (required): Company website to crawl
• companyName (required): Company name
• Optional: userDescription, industryHint, country (default: "Australia")
• Returns: structured profile with name, description, industry, targetAudience, keyProducts, tone

---

9. Post Templates (0 credits for CRUD, 20 credits to render)#

Design and render social media post images using Fabric.js canvas templates.

POST /api/v1/templates - Create a template

json

{
  "name": "LinkedIn Announcement",
  "description": "Clean announcement card for LinkedIn",
  "category": "linkedin",
  "canvasJson": "{...Fabric.js canvas JSON...}",
  "templateMetadata": {
    "fields": [
      { "key": "headline", "objectName": "headline-text", "label": "Headline", "maxLength": 80, "required": true },
      { "key": "body", "objectName": "body-text", "label": "Body Text", "maxLength": 200 }
    ],
    "imageSlots": [
      { "key": "logo", "objectName": "logo-image", "required": true }
    ]
  }
}

• category: "linkedin", "instagram", or "article"
• canvasJson: Valid Fabric.js JSON string (max 500KB). Must contain an objects array with a clip workspace object.
• templateMetadata.fields: Max 20 text fields. Each maps a key to a canvas objectName.
• templateMetadata.imageSlots: Max 10 image slots. Each maps a key to a canvas objectName.

GET /api/v1/templates - List templates

• Query params: ?category=linkedin&limit=10&offset=0
• Returns: templates with pagination (no canvas JSON in list view)

GET /api/v1/templates/{id} - Get template with full canvas JSON

PATCH /api/v1/templates/{id} - Update (name, description, category, canvasJson, templateMetadata, isActive)

DELETE /api/v1/templates/{id} - Delete template

POST /api/v1/templates/{id}/render (20 credits) - Render template to image

json

{
  "fields": {
    "headline": "We Just Launched!",
    "body": "Our new AI-powered content platform is live."
  },
  "images": {
    "logo": "https://cdn.example.com/logo.png"
  },
  "outputFormat": "jpeg",
  "quality": 0.9
}

• fields: Key-value map matching template field keys
• images: Key-value map matching template image slot keys (HTTPS URLs only)
• outputFormat: "jpeg" (default) or "png"
• quality: 0.1-1.0 (default: 0.9)
• Returns: { "creditsConsumed": 20, "imageUrl": "https://cdn...", "width": 1080, "height": 1080 }

---

10. Social Post History (0 credits)#

GET /api/v1/social/history - View past social media posts

• Query params: ?platform=instagram&status=published&limit=20&offset=0
• platform: "instagram", "tiktok", "threads", "linkedin", "youtube"
• status: "pending", "uploading", "processing", "published", "failed", "expired", "cancelled"
• Returns: list of posts with platform, contentType, caption, status, platformPostId, publishedAt

---

11. CMS Publish History (0 credits)#

GET /api/v1/cms/history - View past CMS publications

• Query params: ?platform=wordpress&status=published&limit=20&offset=0
• platform: "wordpress", "ghost", "webflow", "wix", "shopify", "framer", "notion"
• status: "pending", "publishing", "published", "failed", "updated", "cancelled"
• Returns: list with platform, title, status, platformPostUrl, publishedAt, errorMessage

---

Error Handling#

HTTP StatusMeaning401Invalid or missing API key402Insufficient credits429Rate limit exceeded -- wait and retry400Invalid request body -- check error details404Resource not found

All errors: { "error": { "code": "ERROR_CODE", "message": "..." }, "requestId": "..." }

---

Other GenerateBot Skills#

• Core Skill ( generatebot-core): Search for content, run pipelines, manage content library, RSS feeds.
• Video Skill ( generatebot-video): Create video reels from pipeline data.
• Templates Skill ( generatebot-templates): Design and render canvas-based post image templates.
• Workflow Skill ( generatebot-workflows): End-to-end workflow examples and patterns.

---

GenerateBot Templates - Design & Render Post Images#

Base URL: https://generatebot.com/api/v1

Authentication: Bearer token in the Authorization header.

text

Authorization: Bearer GENERATEBOT_API_KEY

All request and response bodies use JSON. Set Content-Type: application/json.

---

Quick Reference#

ActionMethodPathCreditsTypeCreate templatePOST/templates0syncList templatesGET/templates0syncGet templateGET/templates/{id}0syncUpdate templatePATCH/templates/{id}0syncDelete templateDELETE/templates/{id}0syncRender templatePOST/templates/{id}/render20sync

---

System Overview#

Templates are canvas JSON documents with dynamic text and image slots. When rendered, the system substitutes placeholder content with real text and images, auto-fits text to its bounding box, and smart-fits images to cover their target areas. The output is a high-quality image (JPEG or PNG) uploaded to CDN.

---

Canvas JSON Format#

Top-Level Structure

json

{
  "version": "5.3.0",
  "objects": [ ... ],
  "clipPath": {
    "type": "rect",
    "version": "5.3.0",
    "left": 0, "top": 0,
    "width": 1080, "height": 1920,
    "fill": "#0a0a0a",
    "scaleX": 1, "scaleY": 1
  }
}

• version: Always "5.3.0"
• objects: Ordered array of canvas objects (back-to-front rendering order)
• clipPath: Canvas-level clip boundary -- MUST match the clip rect dimensions and fill

The Clip Rect (Workspace)

Every template MUST have a clip rect as its first object. This defines the artboard:

json

{
  "type": "rect",
  "version": "5.3.0",
  "originX": "left", "originY": "top",
  "left": 0, "top": 0,
  "width": 1080, "height": 1920,
  "fill": "#0a0a0a",
  "stroke": null, "strokeWidth": 0,
  "scaleX": 1, "scaleY": 1,
  "opacity": 1, "visible": true,
  "name": "clip",
  "selectable": false, "hasControls": false
}

Common dimensions:

FormatWidthHeightUse CasePortrait / Story10801920Instagram Stories, LinkedIn StoriesSquare10801080Instagram Feed, LinkedIn FeedLandscape1200627LinkedIn Articles, Twitter/X

Object Naming Convention

PatternTypeExamplePurpose{{key}}Dynamic{{title}}, {{primaryImage}}Replaced during renderingPlain nameStaticgradient_overlay_1, accent_lineFixed decorative elementsclipWorkspaceclipArtboard boundary (exactly one)

Image Objects

Image placeholders define where dynamic images appear. The src MUST use a 1x1 transparent pixel -- never an empty string.

json

{
  "type": "image",
  "version": "5.3.0",
  "originX": "left", "originY": "top",
  "left": 0, "top": 0,
  "width": 1200, "height": 800,
  "scaleX": 0.9, "scaleY": 2.4,
  "opacity": 1, "visible": true,
  "name": "{{primaryImage}}",
  "selectable": true, "hasControls": true,
  "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
  "crossOrigin": "anonymous",
  "filters": []
}

Key rules:

• src MUST be the 1x1 transparent pixel base64 shown above. Empty string "" causes rendering failures.
• crossOrigin MUST be "anonymous"
• filters MUST be [] (empty array)
• width/ height define unscaled dimensions; scaleX/ scaleY scale to visual target size
• The renderer auto-fits the actual image to cover the target area (width scaleX by height scaleY)

Circular image crop (optional):

json

{
  "type": "image",
  "name": "{{secondaryImage}}",
  "width": 300, "height": 300,
  "scaleX": 1, "scaleY": 1,
  "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
  "crossOrigin": "anonymous", "filters": [],
  "clipPath": {
    "type": "circle",
    "version": "5.3.0",
    "radius": 140,
    "left": 0, "top": 0,
    "originX": "center", "originY": "center",
    "fill": "rgb(0,0,0)",
    "inverted": false, "absolutePositioned": false
  }
}

Textbox Objects

Use large fontSize directly -- never use scaleX/ scaleY to size text.

json

{
  "type": "textbox",
  "version": "5.3.0",
  "originX": "left", "originY": "top",
  "left": 70, "top": 1050,
  "width": 940, "height": 350,
  "fill": "rgba(255, 255, 255, 1)",
  "stroke": null, "strokeWidth": 0,
  "fontSize": 82, "fontFamily": "Arial", "fontWeight": 900,
  "text": "Headline Goes Here in Bold White Text",
  "textAlign": "left", "lineHeight": 1.08, "charSpacing": 0,
  "scaleX": 1, "scaleY": 1,
  "angle": 0, "opacity": 1, "visible": true,
  "name": "{{title}}",
  "selectable": true, "hasControls": true, "editable": true
}

Key rules:

• fontSize MUST be the actual desired size. Do NOT use scaleX/scaleY to enlarge text -- this breaks auto-fit.
• scaleX and scaleY MUST be 1 on text objects.
• height defines the maximum bounding box -- set it generously. The renderer shrinks text to fit.
• width defines the text wrapping width.

Recommended font sizes by role:

RolefontSizefontWeightNotesTitle / Headline62-82700-900Bold, high-impactDescription / Body32-42400Regular weightLabel / Tag24-28700Often with charSpacing: 80-150Website / URL22-26400-600Subtle, lower opacityCTA24-28600-700Right-aligned or centered

Gradient Overlays

Gradient overlays create dark zones over images where text remains readable. Use a 400x400 base rect, scale it up with scaleX/ scaleY, and flip vertically with flipY: true so the solid color sits at the bottom.

json

{
  "type": "rect",
  "version": "5.3.0",
  "originX": "left", "originY": "top",
  "left": -20, "top": 540,
  "width": 400, "height": 400,
  "fill": {
    "type": "linear",
    "coords": {"x1": 200, "y1": 0, "x2": 200, "y2": 400},
    "colorStops": [
      {"offset": 0, "color": "rgba(0, 0, 0, 1)"},
      {"offset": 0.6, "color": "rgba(0, 0, 0, 0.75)"},
      {"offset": 0.9, "color": "rgba(0, 0, 0, 0)"}
    ],
    "offsetX": 0, "offsetY": 0, "gradientUnits": "pixels"
  },
  "stroke": null, "strokeWidth": 0,
  "scaleX": 2.85, "scaleY": 3.5,
  "flipY": true,
  "opacity": 1, "visible": true,
  "name": "gradient_overlay_1", "selectable": true
}

Best practices:

• Stack TWO gradient rects with slightly different positions and color stop distributions for visual depth
• flipY: true makes offset 0 (solid) appear at the bottom, offset 1 (transparent) at the top
• Gradient covers the bottom 60-70% of the canvas; text sits in the fully opaque zone
• Use left: -20 to ensure full-width coverage after scaling

---

Template Metadata#

Describes which objects are dynamic and how they appear in the editor:

json

{
  "fields": [
    {
      "key": "title",
      "objectName": "{{title}}",
      "label": "Title",
      "maxLength": 80,
      "required": true,
      "defaultValue": "Headline Goes Here in Bold White Text"
    }
  ],
  "imageSlots": [
    {
      "key": "primaryImage",
      "objectName": "{{primaryImage}}",
      "required": true
    }
  ]
}

Rules:

• Every {{key}} object in canvas JSON MUST have a matching entry in fields (text) or imageSlots (images)
• objectName MUST exactly match the object's name including {{ and }}
• Maximum 20 fields, maximum 10 image slots
• defaultValue should match the text property of the corresponding textbox

Standard variable names:

KeyTypePurposeTypical maxLengthtitlefieldMain headline60-100descriptionfieldSupporting text150-250labelfieldCategory tag (e.g., "BREAKING NEWS")20-30websitefieldURL or domain30ctafieldCall to action (e.g., "Read Below")20-30primaryImageimageSlotMain hero image-secondaryImageimageSlotSupporting image (headshot, logo)-

---

API Reference#

POST /templates -- Create Template

json

{
  "name": "News Card Dark",
  "description": "Dark cinematic news card with full-bleed hero image...",
  "category": "linkedin",
  "canvasJson": "{...stringified canvas JSON...}",
  "templateMetadata": {
    "fields": [...],
    "imageSlots": [...]
  }
}

Validation:

• name: 1-200 characters, required
• description: max 1000 characters, optional
• category: "linkedin" | "instagram" | "article", required
• canvasJson: stringified JSON, max 500KB, must contain a clip object
• templateMetadata.fields: max 20 items
• templateMetadata.imageSlots: max 10 items

Response (201):

json

{
  "success": true,
  "data": {
    "template": {
      "id": "uuid",
      "name": "News Card Dark",
      "description": "...",
      "category": "linkedin",
      "template_metadata": {...},
      "thumbnail_url": null,
      "created_at": "2026-04-10T..."
    }
  }
}

GET /templates -- List Templates

Query: ?category=linkedin&limit=10&offset=0

Returns lightweight metadata (no canvas_json). Use GET by ID for the full template.

json

{
  "success": true,
  "data": {
    "templates": [...],
    "pagination": { "total": 12, "limit": 10, "offset": 0, "hasMore": true }
  }
}

GET /templates/{id} -- Get Template

Returns full template including canvas_json.

PATCH /templates/{id} -- Update Template

Partial updates. Send only the fields to change ( name, category, canvasJson, templateMetadata, isActive).

DELETE /templates/{id} -- Delete Template

Returns { "success": true, "data": { "deleted": true } }.

POST /templates/{id}/render -- Render Template (20 credits)

json

{
  "fields": {
    "title": "Breaking: AI Reaches New Milestone",
    "description": "Researchers announce breakthrough in reasoning capabilities.",
    "label": "TECH NEWS",
    "website": "technews.com"
  },
  "images": {
    "primaryImage": "https://example.com/hero.jpg"
  },
  "outputFormat": "jpeg",
  "quality": 0.9
}

• fields: key-value pairs matching template field keys (all strings)
• images: key-value pairs matching template image slot keys (HTTPS URLs only)
• outputFormat: "jpeg" (default) or "png"
• quality: 0.1-1.0, default 0.9

Response:

json

{
  "success": true,
  "data": {
    "imageUrl": "https://generatebot.b-cdn.net/posts/...",
    "width": 1080,
    "height": 1920,
    "creditsConsumed": 20,
    "pipelineRunId": "uuid"
  }
}

---

Text Auto-Fit#

The renderer automatically shrinks text to fit within its bounding box:

1. Set height generously on textbox objects -- this is the max vertical space
2. Use the actual desired fontSize -- the renderer shrinks if text is longer than placeholder
3. Do not rely on scaleX/ scaleY for text sizing -- keep both at 1
4. Test with long text to verify auto-fit behavior

Image Smart-Fit#

The renderer scales images to cover their target area without distortion:

• Target area = width * scaleX by height * scaleY
• Image is scaled uniformly to fill (cover) the target area, centered
• Just provide the image URL at render time -- the system handles all sizing

---

Design Patterns#

Pattern 1: Hero Image with Gradient Overlay (Dark Theme) Best for news, dramatic stories. Full-bleed hero image, two stacked gradient rects, bold white title, subtle description, label at top, website/CTA at bottom.

Pattern 2: Square Card with Accent Line Best for feeds. 1080x1080, aggressive gradient, thin vertical accent line, large caps title, no description.

Pattern 3: Editorial Clean (Light Theme) Best for thought leadership. Light background, colored label badge, serif title, hero image in bottom half.

Pattern 4: Split Dual Image Best for comparisons. Two images separated by a colored title band.

---

Critical Rules#

1. Image src must NEVER be empty string. Always use: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=
2. Text scaleX and scaleY must be 1. Use fontSize for sizing.
3. The clip rect must be the first object with name: "clip".
4. Canvas-level clipPath must match the clip rect's dimensions and fill.
5. Image objects must include crossOrigin: "anonymous" and filters: [].
6. Gradient overlays use 400x400 base size scaled via scaleX/ scaleY. Never use full canvas dimensions directly.
7. Stack TWO gradient rects for depth -- single gradients look flat.
8. Set generous height on textboxes -- this is the auto-fit bounding box.
9. Category must be "linkedin", "instagram", or "article".
10. canvasJson max size is 500KB.
11. Every {{key}} object must have a matching metadata entry.

Available Fonts#

Arial, Arial Black, Verdana, Helvetica, Tahoma, Trebuchet MS, Times New Roman, Georgia, Garamond, Courier New, Brush Script MT, Palatino, Bookman, Comic Sans MS, Impact, Lucida Sans Unicode, Geneva, Lucida Console

Example: Create and Render a Template#

Step 1: Create

bash

curl -X POST https://generatebot.com/api/v1/templates \
  -H "Authorization: Bearer GENERATEBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "News Card Dark",
    "description": "Dark cinematic news card",
    "category": "linkedin",
    "canvasJson": "{...stringified canvas JSON...}",
    "templateMetadata": {
      "fields": [
        {"key": "title", "objectName": "{{title}}", "label": "Title", "maxLength": 80, "required": true, "defaultValue": "Your Headline"}
      ],
      "imageSlots": [
        {"key": "primaryImage", "objectName": "{{primaryImage}}", "required": true}
      ]
    }
  }'

Step 2: Render (20 credits)

bash

curl -X POST https://generatebot.com/api/v1/templates/TEMPLATE_ID/render \
  -H "Authorization: Bearer GENERATEBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": { "title": "AI Breakthrough Announced Today" },
    "images": { "primaryImage": "https://example.com/hero.jpg" },
    "outputFormat": "jpeg",
    "quality": 0.9
  }'

---

Error Handling#

HTTP StatusMeaning401Invalid or missing API key402Insufficient credits429Rate limit exceeded -- wait and retry400Invalid request body -- check error details404Template not found

All errors: { "error": { "code": "ERROR_CODE", "message": "..." }, "requestId": "..." }

---

Other GenerateBot Skills#

• Core Skill ( generatebot-core): Search, pipeline, RSS, content CRUD, and credits endpoints.
• Video Skill ( generatebot-video): Detailed video creation tutorial with imageMode reference.
• Publish Skill ( generatebot-publish): Social posting, CMS publishing, enrichment, brand voice, AI images.
• Workflows Skill ( generatebot-workflows): End-to-end workflow patterns and usage mapping.

---

GenerateBot Workflows - Reference Guide#

Base URL: https://generatebot.com/api/v1

Authentication: Bearer token in the Authorization header.

text

Authorization: Bearer GENERATEBOT_API_KEY

All request and response bodies use JSON. Set Content-Type: application/json.

---

Credit Cost Summary#

ActionCreditsSkillSearch (news-aggregator)10CoreRSS feeds (all operations)0CoreContent pipeline (content-analyzer)100CoreTopic pipeline (full-pipeline)100CoreScript generator pipeline15CoreVideo reel200VideoTemplate render20PublishEnrich (links or images)20 eachPublishBrand voice rewrite5PublishAI image generation10PublishReddit replies10PublishBusiness profile5PublishSave/list content0CoreCredit transactions0CoreTemplate CRUD0PublishSocial media post0PublishSocial post history0PublishCMS publish0PublishCMS publish history0PublishCheck credits0Core

---

Usage Pattern Mapping#

User RequestActionsCredits"search for [topic]"POST /agents/news-aggregator10"get RSS news"POST /rss0"write an article about [topic]"POST /pipelines (full-pipeline)100"create content from [url]"POST /pipelines (content-analyzer)100"make a video about [topic]"Pipeline (100) + Video (200)300"enrich with links/images"POST /enrich/*20 each"generate images"POST /agents/ai-image-generator10"rewrite in brand voice"POST /agents/brand-voice-rewriter5"create a post template"POST /templates0"render a template"POST /templates/{id}/render20"post to [platform]"POST /social/post (needs contentId)0"publish to [cms]"POST /cms/publish (needs contentId)0"show post history"GET /social/history or GET /cms/history0"check credits" / "transactions"GET /credits or GET /credits/transactions0

---

Complete Workflow: Search -> Article -> Video -> Publish#

Step 1: Check credits -- GET /api/v1/credits (0 credits)

• Confirm you have at least 310 credits for the full flow

Step 2: Search for a topic -- POST /api/v1/agents/news-aggregator (10 credits)

• Send: { "topic": "your topic here" }
• Extract the best article URL from the response array

Step 3: Generate content -- POST /api/v1/pipelines (100 credits)

• Send: { "pipelineType": "content-analyzer", "url": "<URL from step 2>" }
• Poll GET /api/v1/pipelines/{runId} every 10s until "completed"

Step 4: Extract content from completed pipeline

• Article: results.data.agents.aiContentGenerator.generatedContent.articles[0]
• Script: results.data.agents.scriptGenerator.scripts[0]
• Images: results.data.agents.imageFinder.foundImages
• Carousel: results.data.agents.carouselGenerator.carousel.slides

Step 5: Save the article -- POST /api/v1/content (0 credits)

json

{
  "contentType": "article",
  "title": "<articles[0].title>",
  "contentData": {
    "introduction": "<articles[0].introduction>",
    "sections": "<articles[0].sections>",
    "metaDescription": "<articles[0].metaDescription>"
  }
}

Save the returned contentId at response.content.id.

Step 6: Publish article to CMS -- POST /api/v1/cms/publish (0 credits)

• GET /api/v1/cms/accounts to get the cmsAccountId
• Convert article to HTML: <p>introduction</p><h2>heading</h2><p>content</p>
• Send with contentId and cmsAccountId

Step 7: Create video reel -- POST /api/v1/videos (200 credits)

• Build slides from carousel + images (see Video skill for full tutorial)
• Include sourcePipelineRunId from step 3
• Poll GET /api/v1/videos/{jobId} every 5s until "completed"

Step 8: Post video to social media -- POST /api/v1/social/post (0 credits)

• GET /api/v1/social/accounts to get connected account IDs
• Use the contentId from the video response with contentType: "video"

Total: ~310 credits (10 search + 100 pipeline + 200 video). CMS and social posting are free.

Tip: Use RSS feeds (POST /rss, 0 credits) instead of the news aggregator (10 credits) to source article URLs for free. Save your feed URLs once with PUT /rss, then fetch with { "useSavedFeeds": true }.

---

RSS-Based Workflow (Free Content Sourcing)#

1. Save RSS feeds: PUT /api/v1/rss with { "feedUrls": ["https://techcrunch.com/feed/"] }
2. Fetch latest: POST /api/v1/rss with { "useSavedFeeds": true, "keywords": ["AI"], "maxItemsPerFeed": 5 }
3. Pick best article URL from the results
4. Run pipeline: POST /api/v1/pipelines on the chosen URL (100 credits)
5. Continue with save/publish/video as needed

---

Behavioral Guidelines#

• For operations costing 50+ credits (pipelines at 100, videos at 200), confirm the action and credit cost before proceeding. For cheap or free operations, proceed directly.
• Show real-time progress while polling async operations. Report the current status on each poll cycle.
• When a pipeline completes, summarize: article title, number of social posts, images found, carousel slides, and script availability.
• When creating a video from pipeline results, always include sourcePipelineRunId.
• Pipeline results are NOT auto-saved. Remind the user to save content (POST /content) before publishing.
• If the user asks to "do everything" or "full workflow", follow the Complete Workflow above.

---

Polling Guide#

Pipelines: Poll every 10 seconds.

• Status: "pending" -> "running" -> "completed" | "failed"
• Typical: 2-3 minutes. Max: 5 minutes.

Videos: Poll every 5 seconds.

• Status: "queued" -> "generating_audio" -> "rendering" -> "uploading" -> "completed" | "failed"
• "queued" can last 10-30 seconds (normal startup)
• "generating_audio" means TTS in progress (progress, not a stall)
• "rendering" is the longest phase
• Typical: 60-180 seconds. Max: 5 minutes.

Images: Synchronous but slow (5-15 seconds per image). Wait for the response.

CRITICAL: Do NOT stop polling on intermediate statuses. Do NOT report failure until status is actually "failed" or you have polled for the maximum duration.

---

Error Handling#

HTTP StatusMeaning401Invalid or missing API key402Insufficient credits429Rate limit exceeded -- wait and retry400Invalid request body -- check error details404Resource not found

All errors: { "error": { "code": "ERROR_CODE", "message": "..." }, "requestId": "..." }

---

Other GenerateBot Skills#

• Core Skill ( generatebot-core): All search, pipeline, RSS, content CRUD, and credits endpoints.
• Video Skill ( generatebot-video): Detailed video creation tutorial with imageMode reference.
• Publish Skill ( generatebot-publish): Social posting, CMS publishing, enrichment, brand voice, AI images.
• Templates Skill ( generatebot-templates): Design and render canvas-based post image templates.