Input Types

PowerPost supports three input types for content generation. Each produces platform-optimized captions with hashtags.

Text

The simplest option — describe what you want to post about.

{
  "prompt": "We just launched our new mobile app with AI features",
  "post_types": ["instagram-reel", "tiktok-video"],
  "research_mode": "regular"
}

The prompt field is required (3-500 characters). PowerPost researches the topic and generates tailored content for each platform.

Images

Upload images via the Upload Media endpoint, then pass the returned media_ids here. PowerPost analyzes the images and generates captions. Optionally provide text for additional context.

Supported formats: JPEG, PNG, WebP

{
  "media_ids": ["a1b2c3d4-...", "e5f6g7h8-..."],
  "prompt": "Behind the scenes at our product launch event",
  "post_types": ["instagram-feed", "facebook-post"],
  "research_mode": "regular"
}

• media_ids — Array of uploaded media IDs (up to 10 images)
• prompt — Optional context to guide the generated content

Video

Upload a video via the Upload Media endpoint, then pass the returned media_id here. PowerPost analyzes the video using AI video understanding and generates captions based on the content.

Supported formats: MP4, MOV

{
  "media_ids": ["f9g0h1i2-..."],
  "prompt": "Focus on the key insights about productivity",
  "post_types": ["tiktok-video", "youtube-short", "x-post"],
  "research_mode": "deep"
}

• media_ids — Array with the uploaded video media ID
• prompt — Optional context to focus the generated content

Comparison

Post Types

You specify which post types you want to generate for. PowerPost derives the platform from each post type and generates one optimized caption per platform.

Output Format

Outputs are keyed by platform — one caption per unique platform derived from your post types:

{
  "tiktok": "🌙 Dark mode activated! POV: your eyes at 2am... #darkmode #tech",
  "instagram": "✨ Dark mode is here!\n\nYour late-night scrolling just got easier... #DarkMode #AppUpdate",
  "youtube": {
    "title": "We Just Shipped Dark Mode",
    "description": "Dark mode is finally here across all our apps... #darkmode #tech"
  }
}

See Also

• Upload Media — Upload images and videos
• Generate Content — Full API reference
• Generate Images — Create AI-generated images
• Credits — Understand credit costs