Mit `smart: true` wählt die KI aussagekräftige Thumbnails aus, anstatt Frames nur in regelmäßigen Abständen zu erfassen. Der Robot bewertet Kandidaten-Frames nach Klarheit, Helligkeit, Komposition, Gesichtern, Gesichtsausdrücken, Handlung und visueller Wirkung und gibt anschließend die besten `count` Frames in chronologischer Reihenfolge zurück. Intelligente Ergebnisse enthalten `file.meta.smart_score` und `file.meta.smart_reasons`. Wenn die KI-Bewertung nicht verfügbar ist, wird die Assembly mit den Kandidaten-Frames in der Ausweichreihenfolge fortgesetzt. Es sind keine eigenen KI-Zugangsdaten erforderlich.

## KI-Preise

Die regulären Verarbeitungskosten für `/video/thumbs` fallen weiterhin an. Die KI-Analyse der Frames wird separat zu den Kosten des zugrunde liegenden Anbieters zuzüglich eines Transloadit-Aufschlags von 50 % berechnet. Die genauen KI-Kosten hängen von der Anzahl der Kandidaten-Frames, dem intern ausgewählten Modell und Anbieterpreis sowie der Größe der Bilddaten ab.

`smart_max_candidates` ist der wichtigste Regler für Kosten und Latenz. Der Robot analysiert bis zu drei Kandidaten pro angefordertem Thumbnail, begrenzt durch `smart_max_candidates`, jedoch nie weniger als `count`. Mit den Standardwerten `count: 8` und `smart_max_candidates: 20` analysiert er 20 Frames und gibt die besten 8 zurück. Ein niedrigerer Grenzwert reduziert KI-Kosten und Latenz; ein höherer gibt der KI mehr Frames zur Auswahl.

###### Hinweis

Verwenden Sie `count` für die intelligente Auswahl. Der Parameter `offsets` dient zum Extrahieren exakter Zeitstempel und sollte nicht mit `smart` kombiniert werden.