Bildstudio

# Bildstudio

Nutze diesen Skill für Standbildgenerierung oder promptbasierte Bildbearbeitung.

## Vor dem Ausführen von CLI-Befehlen

Freebeat CLI ist ein npm-Paket und authentifizierter API-Client. Installiere oder aktualisiere es zuerst:

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

Vor der Generierung muss ein Freebeat API-Schlüssel vorhanden sein. Nutze eines dieser Muster:

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

Prüfe die Zugangsdaten, bevor ein kostenpflichtiger oder langer Workflow startet:

~~~bash
freebeat auth show
freebeat auth test
~~~

Füge den rohen API-Schlüssel nicht ein und logge ihn nicht. Der Nutzer soll ihn im Terminal, Secret Store oder als Umgebungsvariable bereitstellen.

## Unterstützte Bildmodelle

- Nano Banana 2: --model 80
- Nano Banana Pro: --model 64
- Wan V2.7 Image: --model 99
- Wan V2.7 Pro Image: --model 100
- GPT-Image 2: --model 108

Prüfe vor der Generierung ein Modell:

~~~bash
freebeat models help --name 108
~~~

## Neues Bild generieren

~~~bash
freebeat image generate --model 80 --prompt "Albumcover einer Neonstadt" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "Premium-Produktposter mit Studiolicht" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Bild bearbeiten

Die erste CLI-Version akzeptiert genau ein --image. Verwende einen lokalen Dateipfad oder eine Bild-URL.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "mache es filmisch und kampagnenreif" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "verwandle dies in ein poliertes Albumcover" --resolution 1024x1024 --quality medium --wait
~~~

## GPT-Image 2 Parameter

GPT-Image 2 nutzt --model 108 und unterstützt --quality low|medium|high sowie --resolution. Ab freebeat-cli 0.1.2 setzt die CLI ohne Angabe --quality auf medium und --resolution auf 1024x1024. Wenn --resolution fehlt, aber --size gesetzt ist, sendet die CLI den --size-Wert kompatibel als resolution.

## Ausgabe verarbeiten

Bildbefehle geben eine Batch-ID und Seriennummer zurück. Ergänze --json für Skripte oder Agents.

## Fortschritt prüfen

Open-RPC-Bild- und Videobefehle geben eine Batch-ID und Seriennummer zurück. Legacy-MV- und Effektbefehle geben eine Task-ID zurück.

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

Nutze --json, wenn ein Agent, Skript oder CI-Job Task-IDs, Batch-IDs, Seriennummern, Ergebnis-URLs, Credits oder Statuswerte parsen muss.