> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# IA

> Gere legendas, imagens e vídeos UGC com IA

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.

> [!NOTE]
>
> 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.

```bash theme={null}
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` |

```bash Exemplos theme={null}
# 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
```

> [!TIP]
>
> Encadeie a saída com `jq` para extrair apenas o texto gerado. O endpoint retorna um
> campo `content`:
>
> ```bash theme={null}
> 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).

```bash theme={null}
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 |

> [!WARNING]
>
> 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.`

```bash Exemplos theme={null}
# 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.

```bash theme={null}
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` |

```bash Exemplos theme={null}
# 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.

```bash theme={null}
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`) |

```bash Exemplos theme={null}
# 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.

```bash theme={null}
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` |

```bash Exemplos theme={null}
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.

```bash theme={null}
so-me ai:image:get <id>
```

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

```bash Exemplo theme={null}
so-me ai:image:get f200d255-1234-4abc-89de-0123456789ab
```

### ai:image:delete

Exclui uma imagem gerada com IA.

```bash theme={null}
so-me ai:image:delete <id>
```

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

```bash Exemplo theme={null}
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.

```bash theme={null}
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`](#aivideoavatars) **(obrigatório)** |
| `--sound <id>` | ID do som de fundo; veja [`ai:video:sounds`](#aivideosounds) |
| `--title <title>` | Título do vídeo |

```bash Exemplos theme={null}
# 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.

```bash theme={null}
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` |

```bash Exemplos theme={null}
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`.

```bash theme={null}
so-me ai:video:avatars
```

```bash Exemplo theme={null}
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`.

```bash theme={null}
so-me ai:video:sounds [options]
```

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

```bash Exemplos theme={null}
# 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.

```bash theme={null}
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 |

```bash Exemplos theme={null}
# 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.).

```bash theme={null}
so-me ai:video:get <id>
```

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

```bash Exemplo theme={null}
so-me ai:video:get f200d255-1234-4abc-89de-0123456789ab
```

### ai:video:delete

Exclui um vídeo gerado com IA.

```bash theme={null}
so-me ai:video:delete <id>
```

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

```bash Exemplo theme={null}
so-me ai:video:delete f200d255-1234-4abc-89de-0123456789ab
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.