FluxSocial

Cancel a previously scheduled post. Only works for posts with status SCHEDULED.

Check whether a suggestion has been posted and to which platforms. Returns posting status per platform with post URLs.

Check the status of an async video generation. Call this after generate_video to poll for completion. When status is 'completed', the response includes the videoUrl. Poll every 10-15 seconds.

Generate social media post suggestions with AI-written captions, titles, hashtags, and platform-specific adaptations. Returns multiple text suggestions (title, body, tags). For IMAGE format, each suggestion includes imagePrompts — use generate_image to create visuals. For VIDEO format, each suggestion includes videoPrompt (single-scene) or videoScenes (multi-scene) — use generate_video with the video prompt. After the user picks a suggestion, generate the visual separately. Use list_businesses first to get a valid businessId.

Generate an AI image for a specific content suggestion. Costs 50 credits. When called without a customPrompt, the API automatically uses the suggestion's stored imagePrompts[imageIndex] — no need to pass the prompt manually. Call this after generate_content once the user picks a suggestion. For carousel posts, use imageIndex for each slide (0-based).

Generate an AI video using Google Veo 3. Costs 500 credits per ~8 seconds. Video generation is ASYNC — this returns an operationId immediately. You must then poll check_video_status until the video is ready (typically 30-120 seconds). Best for Reels, TikToks, and Stories.

Retrieve a previously generated content suggestion by its ID. Returns the full suggestion including title, body, tags, images, and any posts made from it.

Check your remaining FluxSocial credit balance. Credits are consumed by content generation (text: 5-20, images: 50, videos: 500 credits).

Get the AI-recommended optimal posting time based on Content DNA analysis and platform engagement patterns. Returns a suggested datetime, confidence score, and reasoning. Use the returned scheduledDateTime with schedule_content.

List the user's connected social media accounts (Instagram, TikTok, etc.). Each account has an id, platform, username, and follower count. Use this to find accountIds for post_content.

List the user's businesses. Each business represents a brand or project (e.g. 'My Yoga Studio', 'Downtown Café') with its own social accounts and content. Use the returned business ID for generate_content.

Publish content immediately to one or more social media platforms. For scheduling at a future time, prefer the dedicated schedule_content tool. Use list_accounts first to get valid accountId and platform values. For image posts, call generate_image first to create the visual.

Preview the credit cost for a generation before running it. Use this to check if the user has enough credits.

Schedule content for publishing at a specific future date and time. Provide an ISO 8601 datetime (e.g. "2025-12-25T10:00:00Z"). Use get_optimal_time to find the best posting time based on Content DNA analysis. Posts are published within ~2 minutes of the scheduled time.

Upload a user's own photo or video for posting. The user must provide an HTTPS link to their media (e.g. from Google Drive, Dropbox, iCloud, Imgur, or any public URL). Processes images to Instagram-optimal 1080x1080 and uploads to blob storage. Creates a suggestion ready for post_content or schedule_content. Costs 0 credits. If the user pastes an image directly instead of a link, ask them to share the image as a public URL (e.g. upload to Google Photos or Imgur and share the link).