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

> Générez des légendes, des images et des vidéos UGC avec l'IA

Les commandes d'IA vous permettent de générer des légendes, des images et des vidéos d'avatar/UGC, de parcourir
votre historique de génération et même de générer et programmer une publication en une seule étape.

> [!NOTE]
>
> Chaque commande prend en charge les options globales `--json` (par défaut) / `--table` / `--verbose`,
> ainsi que `--api-key <key>` et `--api-url <url>` (ou les variables d'environnement `SOME_API_KEY` / `SOME_API_URL`).

## Texte

### ai:generate

Génère du contenu texte avec l'IA, éventuellement adapté à une plateforme, un ton et une longueur précis.

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

| Option | Description |
| - | - |
| `--prompt <text>` | Prompt texte **(obligatoire)** |
| `--platform <platform>` | Plateforme sociale cible pour l'optimisation |
| `--tone <tone>` | Ton du contenu (par ex. `professional`, `casual`) |
| `--length <length>` | Longueur du contenu : `short`, `medium`, `long` |

```bash Exemples 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]
>
> Transmettez la sortie à `jq` pour extraire uniquement le texte généré. L'endpoint renvoie un
> champ `content` :
>
> ```bash theme={null}
> so-me ai:generate --prompt "Product launch" | jq -r '.content'
> ```

### ai:generate-and-schedule

Commande en une étape qui génère du contenu et le programme immédiatement comme publication. En interne,
elle génère le texte, résout le premier compte connecté de la plateforme indiquée,
et crée une publication `TEXT` programmée à la date fournie (ou maintenant).

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

| Option | Description | Par défaut |
| - | - | - |
| `--prompt <text>` | Prompt du contenu **(obligatoire)** | — |
| `--platform <platform>` | Plateforme sociale, par ex. `TWITTER`, `LINKEDIN` **(obligatoire)** | — |
| `--date <date>` | Date de programmation au format ISO 8601 | maintenant |

> [!WARNING]
>
> Cette commande nécessite un compte connecté pour la plateforme cible. Si aucun n'est trouvé, la
> commande échoue avec `No <platform> account found. Connect one first.`

```bash Exemples 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

Affiche votre historique de génération IA.

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

| Option | Description | Par défaut |
| - | - | - |
| `--page <number>` | Numéro de page | `1` |
| `--limit <number>` | Éléments par page | `20` |

```bash Exemples 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
```

***

## Images

### ai:image

Génère une image IA à partir d'un prompt texte.

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

| Option | Description |
| - | - |
| `--prompt <text>` | Description de l'image **(obligatoire)** |
| `--style <style>` | Style de l'image |
| `--aspect-ratio <ratio>` | Format d'image (par ex. `1:1`, `16:9`, `9:16`) |

```bash Exemples 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

Liste vos images IA générées.

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

| Option | Description | Par défaut |
| - | - | - |
| `--page <number>` | Numéro de page | `1` |
| `--limit <number>` | Éléments par page | `20` |

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

### ai:image:get

Récupère les détails d'une image IA précise.

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

| Argument | Description |
| - | - |
| `<id>` | UUID de l'image |

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

### ai:image:delete

Supprime une image IA générée.

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

| Argument | Description |
| - | - |
| `<id>` | UUID de l'image |

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

***

## Vidéo (UGC)

Générez et gérez des contenus marketing vidéo d'avatar/UGC par IA.

### ai:video:generate

Génère une vidéo UGC avec l'IA. L'avatar prononce le texte d'accroche fourni. La génération
de vidéo est asynchrone — la commande lance la tâche et renvoie ses détails ;
interrogez `ai:video:get` pour suivre le statut.

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

| Option | Description |
| - | - |
| `--hook <text>` | Texte d'accroche/script prononcé par l'avatar (500 caractères max.) **(obligatoire)** |
| `--avatar <id>` | ID de l'avatar — voir [`ai:video:avatars`](#aivideoavatars) **(obligatoire)** |
| `--sound <id>` | ID du son d'arrière-plan — voir [`ai:video:sounds`](#aivideosounds) |
| `--title <title>` | Titre de la vidéo |

```bash Exemples 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

Liste vos vidéos IA générées.

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

| Option | Description | Par défaut |
| - | - | - |
| `--page <number>` | Numéro de page | `1` |
| `--limit <number>` | Éléments par page | `20` |

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

### ai:video:avatars

Liste les avatars IA disponibles pour la génération de vidéos. Utilisez les ID renvoyés avec
`ai:video:generate --avatar`.

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

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

### ai:video:sounds

Liste les sons d'arrière-plan disponibles, éventuellement filtrés par genre. Utilisez les
ID renvoyés avec `ai:video:generate --sound`.

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

| Option | Description |
| - | - |
| `--genre <name>` | Filtrer par genre |

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

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

### ai:video:hooks

Génère des suggestions d'accroches (phrases d'ouverture) pour des scripts vidéo à partir d'une description
de produit ou de sujet.

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

| Option | Description |
| - | - |
| `--topic <text>` | Description du produit/sujet pour les idées d'accroches **(obligatoire)** |
| `--tone <tone>` | Ton (par ex. `casual`, `professional`, `playful`) |
| `--count <number>` | Nombre de suggestions d'accroches |

```bash Exemples 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

Récupère les détails d'une vidéo IA générée (statut, URL, fournisseur, etc.).

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

| Argument | Description |
| - | - |
| `<id>` | UUID de la vidéo |

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

### ai:video:delete

Supprime une vidéo IA générée.

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

| Argument | Description |
| - | - |
| `<id>` | UUID de la vidéo |

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