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

# KI

> Bildunterschriften, Bilder und UGC-Videos mit KI generieren

Mit den KI-Befehlen generierst du Textunterschriften, Bilder und Avatar-/UGC-Videos, durchsuchst deinen Generierungsverlauf und kannst sogar einen Beitrag in einem einzigen Schritt generieren und planen.

> [!NOTE]
>
> Jeder Befehl unterstützt die globalen Flags `--json` (Standard) / `--table` / `--verbose` sowie `--api-key <key>` und `--api-url <url>` (oder die Umgebungsvariablen `SOME_API_KEY` / `SOME_API_URL`).

## Text

### ai:generate

Generiert Textinhalte mit KI, optional abgestimmt auf eine bestimmte Plattform, einen Ton und eine Länge.

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

| Option | Beschreibung |
| - | - |
| `--prompt <text>` | Text-Prompt **(erforderlich)** |
| `--platform <platform>` | Ziel-Social-Plattform für die Optimierung |
| `--tone <tone>` | Ton des Inhalts (z. B. `professional`, `casual`) |
| `--length <length>` | Länge des Inhalts: `short`, `medium`, `long` |

```bash Beispiele theme={null}
# Einen Tweet generieren
so-me ai:generate --prompt "Write a tweet about our product launch"

# Für die Plattform optimierter LinkedIn-Beitrag
so-me ai:generate --prompt "Announce new feature" --platform LINKEDIN --tone professional

# Kurze, lockere Bildunterschrift
so-me ai:generate --prompt "Weekend vibes" --tone casual --length short
```

> [!TIP]
>
> Leite die Ausgabe an `jq` weiter, um nur den generierten Text zu extrahieren. Der Endpunkt liefert ein Feld `content`:
>
> ```bash theme={null}
> so-me ai:generate --prompt "Product launch" | jq -r '.content'
> ```

### ai:generate-and-schedule

Ein-Schritt-Befehl, der Inhalte generiert und sofort als Beitrag plant. Intern generiert er den Text, löst das erste verbundene Konto der angegebenen Plattform auf und erstellt einen `TEXT`-Beitrag, geplant zum angegebenen Datum (oder jetzt).

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

| Option | Beschreibung | Standard |
| - | - | - |
| `--prompt <text>` | Inhalts-Prompt **(erforderlich)** | — |
| `--platform <platform>` | Social-Plattform, z. B. `TWITTER`, `LINKEDIN` **(erforderlich)** | — |
| `--date <date>` | Geplantes Datum im ISO-8601-Format | jetzt |

> [!WARNING]
>
> Dafür ist ein verbundenes Konto für die Zielplattform erforderlich. Wird keines gefunden, schlägt der Befehl mit `No <platform> account found. Connect one first.` fehl.

```bash Beispiele theme={null}
# Einen Tweet generieren und für jetzt planen
so-me ai:generate-and-schedule --prompt "Exciting news!" --platform TWITTER

# Für einen bestimmten Zeitpunkt planen
so-me ai:generate-and-schedule \
  --prompt "Announce our new feature" \
  --platform LINKEDIN \
  --date 2026-07-01T09:00:00Z
```

### ai:history

Zeigt deinen KI-Generierungsverlauf an.

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

| Option | Beschreibung | Standard |
| - | - | - |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite | `20` |

```bash Beispiele theme={null}
# Erste Seite als Tabelle
so-me ai:history --table

# Zweite Seite, 50 pro Seite
so-me ai:history --page 2 --limit 50
```

***

## Bilder

### ai:image

Generiert ein KI-Bild aus einem Text-Prompt.

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

| Option | Beschreibung |
| - | - |
| `--prompt <text>` | Bildbeschreibung **(erforderlich)** |
| `--style <style>` | Bildstil |
| `--aspect-ratio <ratio>` | Seitenverhältnis (z. B. `1:1`, `16:9`, `9:16`) |

```bash Beispiele theme={null}
# Ein Produktbild generieren
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

Listet deine generierten KI-Bilder auf.

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

| Option | Beschreibung | Standard |
| - | - | - |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite | `20` |

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

### ai:image:get

Ruft die Details eines bestimmten KI-Bildes ab.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Bild-UUID |

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

### ai:image:delete

Löscht ein generiertes KI-Bild.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Bild-UUID |

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

***

## Video (UGC)

Generiere und verwalte KI-Avatar-/UGC-Video-Marketing-Assets.

### ai:video:generate

Generiert ein UGC-Video mit KI. Der Avatar spricht den angegebenen Hook-Text. Die Videogenerierung läuft asynchron — der Befehl startet den Auftrag und gibt dessen Details zurück; frage `ai:video:get` ab, um den Status zu verfolgen.

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

| Option | Beschreibung |
| - | - |
| `--hook <text>` | Hook-/Skript-Text, den der Avatar spricht (max. 500 Zeichen) **(erforderlich)** |
| `--avatar <id>` | Avatar-ID — siehe [`ai:video:avatars`](#aivideoavatars) **(erforderlich)** |
| `--sound <id>` | ID des Hintergrundsounds — siehe [`ai:video:sounds`](#aivideosounds) |
| `--title <title>` | Videotitel |

```bash Beispiele theme={null}
# Minimale Generierung
so-me ai:video:generate --hook "You won't believe this!" --avatar <avatarId>

# Mit Hintergrundsound und Titel
so-me ai:video:generate \
  --hook "New drop today" \
  --avatar <avatarId> \
  --sound <soundId> \
  --title "Launch"
```

### ai:video:list

Listet deine generierten KI-Videos auf.

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

| Option | Beschreibung | Standard |
| - | - | - |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite | `20` |

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

### ai:video:avatars

Listet die verfügbaren KI-Avatare für die Videogenerierung auf. Verwende die zurückgegebenen IDs mit `ai:video:generate --avatar`.

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

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

### ai:video:sounds

Listet die verfügbaren Hintergrundsounds auf, optional nach Genre gefiltert. Verwende die zurückgegebenen IDs mit `ai:video:generate --sound`.

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

| Option | Beschreibung |
| - | - |
| `--genre <name>` | Nach Genre filtern |

```bash Beispiele theme={null}
# Alle Sounds
so-me ai:video:sounds

# Nach Genre filtern
so-me ai:video:sounds --genre chill
```

### ai:video:hooks

Generiert Hook-Vorschläge (Eröffnungszeilen) für Videoskripte aus einer Produkt-/Themenbeschreibung.

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

| Option | Beschreibung |
| - | - |
| `--topic <text>` | Produkt-/Themenbeschreibung für Hook-Ideen **(erforderlich)** |
| `--tone <tone>` | Ton (z. B. `casual`, `professional`, `playful`) |
| `--count <number>` | Anzahl der Hook-Vorschläge |

```bash Beispiele theme={null}
# Hooks für ein Produkt-Launch-Video
so-me ai:video:hooks --topic "our new analytics dashboard"

# Verspielter Ton, fünf Vorschläge
so-me ai:video:hooks --topic "morning routine tips" --tone playful --count 5
```

### ai:video:get

Ruft die Details eines generierten KI-Videos ab (Status, URL, Anbieter usw.).

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Video-UUID |

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

### ai:video:delete

Löscht ein generiertes KI-Video.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Video-UUID |

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