AI - Social media studio

AI commands let you generate text captions, images, and avatar/UGC videos, browse your generation history, and even generate and schedule a post in a single step.

Every command supports the global flags --json (default) / --table / --verbose, plus --api-key <key> and --api-url <url> (or the SOME_API_KEY / SOME_API_URL environment variables).

Text

ai:generate

Generate text content using AI, optionally tailored to a specific platform, tone, and length.

so-me ai:generate --prompt <text> [options]

Option	Description
`--prompt <text>`	Text prompt (required)
`--platform <platform>`	Target social platform for optimization
`--tone <tone>`	Content tone (e.g. `professional`, `casual`)
`--length <length>`	Content length: `short`, `medium`, `long`

Examples

# Generate a tweet
so-me ai:generate --prompt "Write a tweet about our product launch"

# Platform-optimized LinkedIn post
so-me ai:generate --prompt "Announce new feature" --platform LINKEDIN --tone professional

# Short casual caption
so-me ai:generate --prompt "Weekend vibes" --tone casual --length short

Pipe the output to jq to extract just the generated text. The endpoint returns a content field:

so-me ai:generate --prompt "Product launch" | jq -r '.content'

ai:generate-and-schedule

One-shot command that generates content and schedules it as a post immediately. Under the hood it generates the text, resolves the first connected account for the given platform, and creates a TEXT post scheduled at the provided date (or now).

so-me ai:generate-and-schedule --prompt <text> --platform <platform> [options]

Option	Description	Default
`--prompt <text>`	Content prompt (required)	—
`--platform <platform>`	Social platform, e.g. `TWITTER`, `LINKEDIN` (required)	—
`--date <date>`	Scheduled date in ISO 8601 format	now

This requires a connected account for the target platform. If none is found, the command fails with No <platform> account found. Connect one first.

Examples

# Generate and schedule a tweet for now
so-me ai:generate-and-schedule --prompt "Exciting news!" --platform TWITTER

# Schedule for a specific time
so-me ai:generate-and-schedule \
  --prompt "Announce our new feature" \
  --platform LINKEDIN \
  --date 2026-07-01T09:00:00Z

ai:history

View your AI generation history.

so-me ai:history [options]

Option	Description	Default
`--page <number>`	Page number	`1`
`--limit <number>`	Items per page	`20`

Examples

# First page as a table
so-me ai:history --table

# Second page, 50 per page
so-me ai:history --page 2 --limit 50

Images

ai:image

Generate an AI image from a text prompt.

so-me ai:image --prompt <text> [options]

Option	Description
`--prompt <text>`	Image description (required)
`--style <style>`	Image style
`--aspect-ratio <ratio>`	Aspect ratio (e.g. `1:1`, `16:9`, `9:16`)

Examples

# Generate a product image
so-me ai:image --prompt "Modern laptop on a clean desk, minimal aesthetic"

# Instagram story format
so-me ai:image --prompt "Sunset over mountains" --aspect-ratio 9:16 --style realistic

ai:image:list

List your generated AI images.

so-me ai:image:list [options]

Option	Description	Default
`--page <number>`	Page number	`1`
`--limit <number>`	Items per page	`20`

Examples

so-me ai:image:list --table
so-me ai:image:list --page 2 --limit 50

ai:image:get

Get details of a specific AI image.

so-me ai:image:get <id>

Argument	Description
`<id>`	Image UUID

Example

so-me ai:image:get f200d255-1234-4abc-89de-0123456789ab

ai:image:delete

Delete a generated AI image.

so-me ai:image:delete <id>

Argument	Description
`<id>`	Image UUID

Example

so-me ai:image:delete f200d255-1234-4abc-89de-0123456789ab

Video (UGC)

Generate and manage AI avatar/UGC video marketing assets.

ai:video:generate

Generate a UGC video with AI. The avatar speaks the supplied hook text. Video generation is asynchronous — the command starts the job and returns its details; poll ai:video:get to track status.

so-me ai:video:generate --hook <text> --avatar <id> [options]

Option	Description
`--hook <text>`	Hook/script text the avatar speaks (max 500 chars) (required)
`--avatar <id>`	Avatar ID — see `ai:video:avatars` (required)
`--sound <id>`	Background sound ID — see `ai:video:sounds`
`--title <title>`	Video title

Examples

# Minimal generation
so-me ai:video:generate --hook "You won't believe this!" --avatar <avatarId>

# With background sound and a title
so-me ai:video:generate \
  --hook "New drop today" \
  --avatar <avatarId> \
  --sound <soundId> \
  --title "Launch"

ai:video:list

List your generated AI videos.

so-me ai:video:list [options]

Option	Description	Default
`--page <number>`	Page number	`1`
`--limit <number>`	Items per page	`20`

Examples

so-me ai:video:list --table
so-me ai:video:list --page 2 --limit 50

ai:video:avatars

List the available AI avatars for video generation. Use the returned IDs with ai:video:generate --avatar.

so-me ai:video:avatars

Example

so-me ai:video:avatars --table

ai:video:sounds

List the available background sounds, optionally filtered by genre. Use the returned IDs with ai:video:generate --sound.

so-me ai:video:sounds [options]

Option	Description
`--genre <name>`	Filter by genre

Examples

# All sounds
so-me ai:video:sounds

# Filter by genre
so-me ai:video:sounds --genre chill

ai:video:hooks

Generate hook (opening-line) suggestions for video scripts from a product/topic description.

so-me ai:video:hooks --topic <text> [options]

Option	Description
`--topic <text>`	Product/topic description for hook ideas (required)
`--tone <tone>`	Tone (e.g. `casual`, `professional`, `playful`)
`--count <number>`	Number of hook suggestions

Examples

# Hooks for a product-launch video
so-me ai:video:hooks --topic "our new analytics dashboard"

# Playful tone, five suggestions
so-me ai:video:hooks --topic "morning routine tips" --tone playful --count 5

ai:video:get

Get details for a generated AI video (status, URL, provider, etc.).

so-me ai:video:get <id>

Argument	Description
`<id>`	Video UUID

Example

so-me ai:video:get f200d255-1234-4abc-89de-0123456789ab

ai:video:delete

Delete a generated AI video.

so-me ai:video:delete <id>

Argument	Description
`<id>`	Video UUID

Example

so-me ai:video:delete f200d255-1234-4abc-89de-0123456789ab

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

AI

Text

ai:generate

ai:generate-and-schedule

ai:history

Images

ai:image

ai:image:list

ai:image:get

ai:image:delete

Video (UGC)

ai:video:generate

ai:video:list

ai:video:avatars

ai:video:sounds

ai:video:hooks

ai:video:get

ai:video:delete

​Text

​ai:generate

​ai:generate-and-schedule

​ai:history

​Images

​ai:image

​ai:image:list

​ai:image:get

​ai:image:delete

​Video (UGC)

​ai:video:generate

​ai:video:list

​ai:video:avatars

​ai:video:sounds

​ai:video:hooks

​ai:video:get

​ai:video:delete

Text

ai:generate

ai:generate-and-schedule

ai:history

Images

ai:image

ai:image:list

ai:image:get

ai:image:delete

Video (UGC)

ai:video:generate

ai:video:list

ai:video:avatars

ai:video:sounds

ai:video:hooks

ai:video:get

ai:video:delete