carousel

carousel tools (scope: mcp:read, credits: ~0)

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel.

POST

https://api.socialneuron.com

/v1/tools/create_carousel

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel. When brand_id is provided, auto-injects brand colors, logo watermark, and visual mood into every image prompt. Returns carousel data + image job_ids. Poll each job_id with check_status until complete, then call schedule_post with job_ids to publish as Instagram carousel (media_type=CAROUSEL_ALBUM).

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel. › Request Body

topic

string · required

Carousel topic/hook — be specific. Example: "5 pricing mistakes that kill SaaS startups" beats "SaaS tips".

image_model

string · enum · required

Image model for slide visuals. flux-pro for general purpose, imagen4 for photorealistic, midjourney for artistic.

Enum values:

midjourney

nano-banana

nano-banana-pro

flux-pro

flux-max

gpt4o-image

imagen4

imagen4-fast

template_id

string · enum

Carousel template. Default: hormozi-authority.

Enum values:

educational-series

product-showcase

story-arc

before-after

step-by-step

quote-collection

data-stats

myth-vs-reality

slide_count

number

Number of slides (3-10). Default: 7.

aspect_ratio

string · enum

Aspect ratio for both carousel and images. Default: 1:1.

Enum values:

1:1

4:5

9:16

style

string · enum

Visual style. Default: hormozi for hormozi-authority template.

Enum values:

minimal

bold

professional

playful

hormozi

image_style_suffix

string

Style suffix appended to every image prompt for visual consistency across slides. Example: "dark moody lighting, cinematic, 35mm film grain".

hook

string

Explicit hook/opener for slide 1. Overrides any hook derived from topic. Keep under 15 words for strongest scroll-stop.

hook_family

string · enum

Hook family tag. Recorded on the carousel so downstream analytics + bandit learners can attribute engagement to hook pattern.

Enum values:

curiosity

authority

pain_point

contrarian

data_driven

cta_text

string

Explicit CTA copy for the final slide. If omitted, derived from topic.

cta_url

string · uri

URL promoted on the CTA slide. Defaults to the project landing page.

tone

string

Voice/tone override. Composes with the brand profile voice when present. Example: "educational, confident, not arrogant".

constraints

string

Content constraints applied at generation time. Example: "No fabricated statistics. Sentence case only. No ALL CAPS."

platform

string · enum

Target platform. Affects tone conventions and slide-count guardrails.

Enum values:

instagram

tiktok

brand_id

string

Brand/project ID to pull visual context from (colors, logo, mood). Falls back to project_id, then default project.

project_id

string

Project ID to associate the carousel with.

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel. › Responses

Successful tool execution.

object[]

POST/v1/tools/create_carousel

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/create_carousel \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "topic",
  "image_model": "midjourney",
  "template_id": "educational-series",
  "slide_count": 0,
  "aspect_ratio": "1:1",
  "style": "minimal",
  "image_style_suffix": "image_style_suffix",
  "hook": "hook",
  "hook_family": "curiosity",
  "cta_text": "cta_text",
  "cta_url": "https://www.example.com/path/to/resource",
  "tone": "tone",
  "constraints": "constraints",
  "platform": "linkedin",
  "brand_id": "brand_id",
  "project_id": "project_id",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "topic": "topic",
  "image_model": "midjourney",
  "template_id": "educational-series",
  "slide_count": 0,
  "aspect_ratio": "1:1",
  "style": "minimal",
  "image_style_suffix": "image_style_suffix",
  "hook": "hook",
  "hook_family": "curiosity",
  "cta_text": "cta_text",
  "cta_url": "https://www.example.com/path/to/resource",
  "tone": "tone",
  "constraints": "constraints",
  "platform": "linkedin",
  "brand_id": "brand_id",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

brandRuntime Comments

Social Neuron MCP Tools API

carousel

carousel tools (scope: mcp:read, credits: ~0)

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel.

POST

https://api.socialneuron.com

/v1/tools/create_carousel

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel. › Request Body

topic

string · required

Carousel topic/hook — be specific. Example: "5 pricing mistakes that kill SaaS startups" beats "SaaS tips".

image_model

string · enum · required

Image model for slide visuals. flux-pro for general purpose, imagen4 for photorealistic, midjourney for artistic.

Enum values:

midjourney

nano-banana

nano-banana-pro

flux-pro

flux-max

gpt4o-image

imagen4

imagen4-fast

template_id

string · enum

Carousel template. Default: hormozi-authority.

Enum values:

educational-series

product-showcase

story-arc

before-after

step-by-step

quote-collection

data-stats

myth-vs-reality

slide_count

number

Number of slides (3-10). Default: 7.

aspect_ratio

string · enum

Aspect ratio for both carousel and images. Default: 1:1.

Enum values:

1:1

4:5

9:16

style

string · enum

Visual style. Default: hormozi for hormozi-authority template.

Enum values:

minimal

bold

professional

playful

hormozi

image_style_suffix

string

Style suffix appended to every image prompt for visual consistency across slides. Example: "dark moody lighting, cinematic, 35mm film grain".

hook

string

Explicit hook/opener for slide 1. Overrides any hook derived from topic. Keep under 15 words for strongest scroll-stop.

hook_family

string · enum

Hook family tag. Recorded on the carousel so downstream analytics + bandit learners can attribute engagement to hook pattern.

Enum values:

curiosity

authority

pain_point

contrarian

data_driven

cta_text

string

Explicit CTA copy for the final slide. If omitted, derived from topic.

cta_url

string · uri

URL promoted on the CTA slide. Defaults to the project landing page.

tone

string

Voice/tone override. Composes with the brand profile voice when present. Example: "educational, confident, not arrogant".

constraints

string

Content constraints applied at generation time. Example: "No fabricated statistics. Sentence case only. No ALL CAPS."

platform

string · enum

Target platform. Affects tone conventions and slide-count guardrails.

Enum values:

instagram

tiktok

brand_id

string

Brand/project ID to pull visual context from (colors, logo, mood). Falls back to project_id, then default project.

project_id

string

Project ID to associate the carousel with.

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel. › Responses

Successful tool execution.

object[]

POST/v1/tools/create_carousel

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/create_carousel \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "topic",
  "image_model": "midjourney",
  "template_id": "educational-series",
  "slide_count": 0,
  "aspect_ratio": "1:1",
  "style": "minimal",
  "image_style_suffix": "image_style_suffix",
  "hook": "hook",
  "hook_family": "curiosity",
  "cta_text": "cta_text",
  "cta_url": "https://www.example.com/path/to/resource",
  "tone": "tone",
  "constraints": "constraints",
  "platform": "linkedin",
  "brand_id": "brand_id",
  "project_id": "project_id",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "topic": "topic",
  "image_model": "midjourney",
  "template_id": "educational-series",
  "slide_count": 0,
  "aspect_ratio": "1:1",
  "style": "minimal",
  "image_style_suffix": "image_style_suffix",
  "hook": "hook",
  "hook_family": "curiosity",
  "cta_text": "cta_text",
  "cta_url": "https://www.example.com/path/to/resource",
  "tone": "tone",
  "constraints": "constraints",
  "platform": "linkedin",
  "brand_id": "brand_id",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

brandRuntime Comments