IA - Social media studio

Os comandos de IA permitem gerar legendas de texto, imagens e vídeos de avatar/UGC, consultar o seu histórico de gerações e até gerar e agendar um post em uma única etapa.

Todos os comandos aceitam as flags globais --json (padrão) / --table / --verbose, além de --api-key <key> e --api-url <url> (ou as variáveis de ambiente SOME_API_KEY / SOME_API_URL).

Texto

ai:generate

Gera conteúdo de texto com IA, opcionalmente adaptado a uma plataforma, um tom e um tamanho específicos.

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

Opção	Descrição
`--prompt <text>`	Prompt de texto (obrigatório)
`--platform <platform>`	Plataforma social de destino para otimização
`--tone <tone>`	Tom do conteúdo (por exemplo, `professional`, `casual`)
`--length <length>`	Tamanho do conteúdo: `short`, `medium`, `long`

Exemplos

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

# Post do LinkedIn otimizado para a plataforma
so-me ai:generate --prompt "Announce new feature" --platform LINKEDIN --tone professional

# Legenda curta e descontraída
so-me ai:generate --prompt "Weekend vibes" --tone casual --length short

Encadeie a saída com jq para extrair apenas o texto gerado. O endpoint retorna um campo content:

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

ai:generate-and-schedule

Comando de uma só etapa que gera o conteúdo e o agenda imediatamente como um post. Por baixo dos panos, ele gera o texto, resolve a primeira conta conectada da plataforma informada e cria um post TEXT agendado para a data informada (ou para agora).

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

Opção	Descrição	Padrão
`--prompt <text>`	Prompt do conteúdo (obrigatório)	—
`--platform <platform>`	Plataforma social, por exemplo `TWITTER`, `LINKEDIN` (obrigatório)	—
`--date <date>`	Data de agendamento no formato ISO 8601	agora

Isso exige uma conta conectada para a plataforma de destino. Se nenhuma for encontrada, o comando falha com No <platform> account found. Connect one first.

Exemplos

# Gerar e agendar um tweet para agora
so-me ai:generate-and-schedule --prompt "Exciting news!" --platform TWITTER

# Agendar para um horário específico
so-me ai:generate-and-schedule \
  --prompt "Announce our new feature" \
  --platform LINKEDIN \
  --date 2026-07-01T09:00:00Z

ai:history

Exibe o seu histórico de gerações de IA.

so-me ai:history [options]

Opção	Descrição	Padrão
`--page <number>`	Número da página	`1`
`--limit <number>`	Itens por página	`20`

Exemplos

# Primeira página como tabela
so-me ai:history --table

# Segunda página, 50 por página
so-me ai:history --page 2 --limit 50

Imagens

ai:image

Gera uma imagem com IA a partir de um prompt de texto.

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

Opção	Descrição
`--prompt <text>`	Descrição da imagem (obrigatório)
`--style <style>`	Estilo da imagem
`--aspect-ratio <ratio>`	Proporção (por exemplo, `1:1`, `16:9`, `9:16`)

Exemplos

# Gerar uma imagem de produto
so-me ai:image --prompt "Modern laptop on a clean desk, minimal aesthetic"

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

ai:image:list

Lista as suas imagens geradas com IA.

so-me ai:image:list [options]

Opção	Descrição	Padrão
`--page <number>`	Número da página	`1`
`--limit <number>`	Itens por página	`20`

Exemplos

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

ai:image:get

Obtém os detalhes de uma imagem de IA específica.

so-me ai:image:get <id>

Argumento	Descrição
`<id>`	UUID da imagem

Exemplo

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

ai:image:delete

Exclui uma imagem gerada com IA.

so-me ai:image:delete <id>

Argumento	Descrição
`<id>`	UUID da imagem

Exemplo

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

Vídeo (UGC)

Gere e gerencie ativos de marketing em vídeo de avatar/UGC com IA.

ai:video:generate

Gera um vídeo UGC com IA. O avatar fala o texto de gancho informado. A geração de vídeo é assíncrona: o comando inicia o trabalho e retorna seus detalhes; consulte ai:video:get repetidamente para acompanhar o status.

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

Opção	Descrição
`--hook <text>`	Texto de gancho/roteiro que o avatar fala (máx. 500 caracteres) (obrigatório)
`--avatar <id>`	ID do avatar; veja `ai:video:avatars` (obrigatório)
`--sound <id>`	ID do som de fundo; veja `ai:video:sounds`
`--title <title>`	Título do vídeo

Exemplos

# Geração mínima
so-me ai:video:generate --hook "You won't believe this!" --avatar <avatarId>

# Com som de fundo e um título
so-me ai:video:generate \
  --hook "New drop today" \
  --avatar <avatarId> \
  --sound <soundId> \
  --title "Launch"

ai:video:list

Lista os seus vídeos gerados com IA.

so-me ai:video:list [options]

Opção	Descrição	Padrão
`--page <number>`	Número da página	`1`
`--limit <number>`	Itens por página	`20`

Exemplos

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

ai:video:avatars

Lista os avatares de IA disponíveis para a geração de vídeo. Use os IDs retornados com ai:video:generate --avatar.

so-me ai:video:avatars

Exemplo

so-me ai:video:avatars --table

ai:video:sounds

Lista os sons de fundo disponíveis, com filtro opcional por gênero. Use os IDs retornados com ai:video:generate --sound.

so-me ai:video:sounds [options]

Opção	Descrição
`--genre <name>`	Filtra por gênero

Exemplos

# Todos os sons
so-me ai:video:sounds

# Filtrar por gênero
so-me ai:video:sounds --genre chill

ai:video:hooks

Gera sugestões de ganchos (frases de abertura) para roteiros de vídeo a partir da descrição de um produto/tema.

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

Opção	Descrição
`--topic <text>`	Descrição do produto/tema para as ideias de gancho (obrigatório)
`--tone <tone>`	Tom (por exemplo, `casual`, `professional`, `playful`)
`--count <number>`	Número de sugestões de gancho

Exemplos

# Ganchos para um vídeo de lançamento de produto
so-me ai:video:hooks --topic "our new analytics dashboard"

# Tom divertido, cinco sugestões
so-me ai:video:hooks --topic "morning routine tips" --tone playful --count 5

ai:video:get

Obtém os detalhes de um vídeo gerado com IA (status, URL, provedor etc.).

so-me ai:video:get <id>

Argumento	Descrição
`<id>`	UUID do vídeo

Exemplo

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

ai:video:delete

Exclui um vídeo gerado com IA.

so-me ai:video:delete <id>

Argumento	Descrição
`<id>`	UUID do vídeo

Exemplo

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

Primeiros passos

Publicação

AI Studio

Caixa de entrada e engajamento

Análises

Biolink

Equipe e colaboração

Configurações e cobrança

Webhooks

Suporte

IA

Texto

ai:generate

ai:generate-and-schedule

ai:history

Imagens

ai:image

ai:image:list

ai:image:get

ai:image:delete

Vídeo (UGC)

ai:video:generate

ai:video:list

ai:video:avatars

ai:video:sounds

ai:video:hooks

ai:video:get

ai:video:delete

​Texto

​ai:generate

​ai:generate-and-schedule

​ai:history

​Imagens

​ai:image

​ai:image:list

​ai:image:get

​ai:image:delete

​Vídeo (UGC)

​ai:video:generate

​ai:video:list

​ai:video:avatars

​ai:video:sounds

​ai:video:hooks

​ai:video:get

​ai:video:delete

Texto

ai:generate

ai:generate-and-schedule

ai:history

Imagens

ai:image

ai:image:list

ai:image:get

ai:image:delete

Vídeo (UGC)

ai:video:generate

ai:video:list

ai:video:avatars

ai:video:sounds

ai:video:hooks

ai:video:get

ai:video:delete