> ## 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

> Genera pies de foto, imágenes y vídeos UGC con IA

Los comandos de IA te permiten generar textos para pies de foto, imágenes y vídeos de avatar/UGC, consultar
tu historial de generaciones e incluso generar y programar una publicación en un solo paso.

> [!NOTE]
>
> Todos los comandos admiten las opciones globales `--json` (por defecto) / `--table` / `--verbose`,
> además de `--api-key <key>` y `--api-url <url>` (o las variables de entorno `SOME_API_KEY` / `SOME_API_URL`).

## Texto

### ai:generate

Genera contenido de texto con IA, con la posibilidad de adaptarlo a una plataforma, un tono y una longitud concretos.

```bash theme={null}
so-me ai:generate --prompt <text> [options]
```

| Opción | Descripción |
| - | - |
| `--prompt <text>` | Indicación de texto (prompt) **(obligatorio)** |
| `--platform <platform>` | Red social de destino para optimizar el contenido |
| `--tone <tone>` | Tono del contenido (p. ej. `professional`, `casual`) |
| `--length <length>` | Longitud del contenido: `short`, `medium`, `long` |

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

> [!TIP]
>
> Encadena la salida con `jq` para extraer solo el texto generado. El endpoint devuelve un
> campo `content`:
>
> ```bash theme={null}
> so-me ai:generate --prompt "Product launch" | jq -r '.content'
> ```

### ai:generate-and-schedule

Comando todo en uno que genera contenido y lo programa como publicación de inmediato. Internamente
genera el texto, resuelve la primera cuenta conectada de la
plataforma indicada y crea una publicación `TEXT` programada para la fecha indicada (o para ahora).

```bash theme={null}
so-me ai:generate-and-schedule --prompt <text> --platform <platform> [options]
```

| Opción | Descripción | Por defecto |
| - | - | - |
| `--prompt <text>` | Indicación del contenido **(obligatorio)** | — |
| `--platform <platform>` | Red social, p. ej. `TWITTER`, `LINKEDIN` **(obligatorio)** | — |
| `--date <date>` | Fecha programada en formato ISO 8601 | ahora |

> [!WARNING]
>
> Requiere una cuenta conectada de la plataforma de destino. Si no se encuentra ninguna, el
> comando falla con `No <platform> account found. Connect one first.`

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

Consulta tu historial de generaciones con IA.

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

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `20` |

```bash Ejemplos theme={null}
# First page as a table
so-me ai:history --table

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

***

## Imágenes

### ai:image

Genera una imagen con IA a partir de una indicación de texto.

```bash theme={null}
so-me ai:image --prompt <text> [options]
```

| Opción | Descripción |
| - | - |
| `--prompt <text>` | Descripción de la imagen **(obligatorio)** |
| `--style <style>` | Estilo de la imagen |
| `--aspect-ratio <ratio>` | Relación de aspecto (p. ej. `1:1`, `16:9`, `9:16`) |

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

Lista tus imágenes generadas con IA.

```bash theme={null}
so-me ai:image:list [options]
```

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `20` |

```bash Ejemplos theme={null}
so-me ai:image:list --table
so-me ai:image:list --page 2 --limit 50
```

### ai:image:get

Obtiene los detalles de una imagen de IA concreta.

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

| Argumento | Descripción |
| - | - |
| `<id>` | UUID de la imagen |

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

### ai:image:delete

Elimina una imagen generada con IA.

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

| Argumento | Descripción |
| - | - |
| `<id>` | UUID de la imagen |

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

***

## Vídeo (UGC)

Genera y gestiona recursos de marketing en vídeo con avatares de IA/UGC.

### ai:video:generate

Genera un vídeo UGC con IA. El avatar dice el texto del gancho (hook) indicado. La generación
de vídeo es asíncrona: el comando inicia el trabajo y devuelve sus detalles;
consulta periódicamente `ai:video:get` para seguir el estado.

```bash theme={null}
so-me ai:video:generate --hook <text> --avatar <id> [options]
```

| Opción | Descripción |
| - | - |
| `--hook <text>` | Texto del gancho o guion que dice el avatar (máx. 500 caracteres) **(obligatorio)** |
| `--avatar <id>` | ID del avatar; consulta [`ai:video:avatars`](#aivideoavatars) **(obligatorio)** |
| `--sound <id>` | ID del sonido de fondo; consulta [`ai:video:sounds`](#aivideosounds) |
| `--title <title>` | Título del vídeo |

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

Lista tus vídeos generados con IA.

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

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `20` |

```bash Ejemplos theme={null}
so-me ai:video:list --table
so-me ai:video:list --page 2 --limit 50
```

### ai:video:avatars

Lista los avatares de IA disponibles para generar vídeo. Usa los ID devueltos con
`ai:video:generate --avatar`.

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

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

### ai:video:sounds

Lista los sonidos de fondo disponibles, con la opción de filtrar por género. Usa los
ID devueltos con `ai:video:generate --sound`.

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

| Opción | Descripción |
| - | - |
| `--genre <name>` | Filtra por género |

```bash Ejemplos theme={null}
# All sounds
so-me ai:video:sounds

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

### ai:video:hooks

Genera sugerencias de ganchos (frases de apertura) para guiones de vídeo a partir de la descripción de un
producto o tema.

```bash theme={null}
so-me ai:video:hooks --topic <text> [options]
```

| Opción | Descripción |
| - | - |
| `--topic <text>` | Descripción del producto o tema para las ideas de ganchos **(obligatorio)** |
| `--tone <tone>` | Tono (p. ej. `casual`, `professional`, `playful`) |
| `--count <number>` | Número de sugerencias de ganchos |

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

Obtiene los detalles de un vídeo generado con IA (estado, URL, proveedor, etc.).

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

| Argumento | Descripción |
| - | - |
| `<id>` | UUID del vídeo |

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

### ai:video:delete

Elimina un vídeo generado con IA.

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

| Argumento | Descripción |
| - | - |
| `<id>` | UUID del vídeo |

```bash Ejemplo 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.