Synesty Docs

VanceAI

Mit dem Add-On für VanceAIopen in new window können Bilder bearbeitet und optimiert werden.

Zugangsdaten

Um das VanceAI Addon nutzen zu können benötigen Sie den API Token. Nach der Registrierung ist dieser hieropen in new window zu finden.

Allgemeines zu Prozess

Bevor Sie eine Aktion (Bildbearbeitung) beginnen können müssen Sie die Bilder, welche bearbeitet werden sollen, auf Ihren VanceAI Account hochgeladen werden. Als Antwort wird für jede Datei eine uid ausgegeben. Die uid ist die interne Referenz die später von den Transformations-Steps verwendet wird.

Hier bietet es sich an das Output-Spreadsheet des VanceAIUploadImages-Steps direkt in einem Datastore zu speichern und diese Daten dann später als Input-Spreadsheet in die Transformations-Steps zu geben.

Workflow

  1. Datei-Upload
  2. Erhalt der uid's
  3. Transformation der hochgeladenen Medien (referenziert über die uid)
  4. Download der bearbeiteten Medien

Step: VanceAIUploadImages

Dieser Step läd eine Liste von Bildern in Ihren VanceAI-Account. Im Output-Spreadsheet wird dann ein Spreadsheet mit uid's ausgegeben welche für die anderen VanceAI-Steps benötigt werden.

Unterstützte Formate

  • VanceAI unterstütztim Moment nur Bilder im JPG und PNG Format

Upload Beschränkungen

  • die Dateigröße darf nicht größer als 10 MB sein
  • die maximale Auflösung darf maximal 34 Megapixel betragen
  • bei Überschreitung der Grenzen wird eine Fehlermeldung ausgegeben

Beispiel:

Wenn Ihr Bild beispielsweise eine Größe von 7680x4320 hat, beträgt die Auflösung 33 MP (33.177.600 Pixel), was weniger als 34 MP ist.

images

  • Datei oder Datei-Liste mit Bildern im unterstützten Format

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

Outputs:

result

Spreadsheet mit den erfolgreich hochgeladenen Medien.

  • hier finden sich die uid's der Hochgeladenen Bilder

failed

Spreadsheet mit den Uploads die fehlgeschlagen sind. (hier: falsches Dateiformat)

In Beiden Spreadsheetswerden Status-Codes angezeigt. Die Spalte code_msg beinhaltet die textuelle Bedeutung des Zahlencodes der Spalte code.

mögliche Codes sind:

  • 200 - Operation successful
  • 10001 - Illegal parameter
  • 10010 - Internal error
  • 10011 - File doesn't exist OR Invalid download link
  • 10012 - Resolution or file size exceeds the limits.
  • 10013 - jparam parse error
  • 10014 - Job failed and exited for unexpected reason
  • 30001 - Invalid API token
  • 30004 - Insufficient credits

Step: VanceAIEnlargeImages

Dieser Step verarbeitet ein Spreadsheet mit uid's und vergrößert Bilder mit Hilfe von AI-gestützten Algorythmen bis zu 800% bei gleichbleibend hoher Qualität.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

Spalten

  • uid - Pflichtspalte
  • filename - optional - Name der Datei
  • processed_filename - optional - Name der neuen bearbeiteten Datei (wenn leer gelassen wird der filename verwendet)

Hinweis:

Das Input-Spreadsheet ist bei allen Transformations-Steps identisch und wird bei den folgenden Steps weiter erläutert.

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

module

  • Modul das verwendet werden soll

Optionen:

  • EnlargeStandard_2x_Stable
  • EnlargeStandard_4x_Stable

auto_params

  • Wenn auf true gesetzt, werden suppress_noise und remove_blur ignoriert. Die KI wählt die optimalen Parameter automatisch entsprechend dem Training aus.

suppress_noise

  • legt fest wie groß der Faktor für das entfernen des Bildrauschens ist
  • gültige Werte: 0-100

remove_blur

  • legt fest wie groß der Faktor für das entfernen des Bildunschärfe ist
  • gültige Werte: 0-100

scale

  • Skalierungs-Faktor
  • gültige Werte bei model:
    • EnlargeStandard_2x_Stable: 2
    • EnlargeStandard_4x_Stable: 4, 6 oder 8

Outputs:

unfinished

Spreadsheet mit den uid, deren server-seitige Verarbeitung noch nicht abgeschlossen ist.

  • Spreadsheet mit den uid's mit Verarbeitungs-Status:
    • waiting
    • process
    • busy
    • fatal

failed

  • Spreadsheet mit den uid's welche durch Fehler nicht verarbeitet werden konnten

files

  • alle uid's deren Verarbeitungs-Status:
    • finish oder
    • webhook ist
  • Datei-Liste mit den fertigen verarbeiteten Medien

Hinweis:

Die Outputs, Fehler- und Status-Codes sind bei allen Transformations-Steps identisch und werden bei den folgenden Steps nicht mehr genannt.

Step: VancedAIDenoiseImages

Dieser Step verarbeitet ein Spreadsheet mit uid's und entfernt Körnung (grain) und Rauschen (noise) mit Hilfe von AI-gestützten Algorythmen aus Bildern.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

auto_params

  • Wenn auf true gesetzt, werden remove_noise und sharpen ignoriert. Die KI wählt die optimalen Parameter automatisch entsprechend dem Training aus.

remove_noise

  • legt fest wie groß der Faktor für das entfernen des Bildrauschens ist
  • gültige Werte: 0-100

sharpen

  • legt fest wie groß der Faktor für die Bildschärfe ist
  • gültige Werte: 0-100

Step: VancedAISharpenImages

Dieser Step verarbeitet ein Spreadsheet mit uid's und erhöht die Bildschärfe mit Hilfe von AI-gestützten Algorythmen.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

module

  • Modul das verwendet werden soll

Optionen:

  • sharpen - für "weiche" Bilder
  • debouncing - für Bilder mit Bewegungsunschärfe

auto_params

  • Wenn auf true gesetzt, werden sharpeness und suppress_noise ignoriert. Die KI wählt die optimalen Parameter automatisch entsprechend dem Training aus.

sharpeness

  • legt fest wie groß der Faktor für die Bildschärfe ist
  • gültige Werte: 0-100

suppress_noise

  • legt fest wie groß der Faktor für Unterdrückung des Bildrauschens ist
  • gültige Werte: 0-100

Step: VanceAIRemoveBackground

Dieser Step verarbeitet ein Spreadsheet mit uid's und entfernt mit Hilfe von AI-gestützten Algorythmen den Hintergrund aus Bildern bzw. schneidet Objekte aus Bildern aus.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

module

  • Modul das verwendet werden soll

Optionen:

  • MattingStable - hauptsächlich zum ausschneiden von Objekten
  • PortraitMattingStable - hauptsächlich für Portraits mit Menschen

no_face_blur

  • wird nur verwendet wenn Modul PortraitMattingStable ausgewählt ist
  • Weichzeichnung des Gesichtes
  • auf true gesetzt, werden Gesichter nicht weich gezeichnet
  • auf false gesetzt, werden Gesichter weich gezeichnet

Step: VanceAIDehazePhotos

Dieser Step verarbeitet ein Spreadsheet mit uid's und entfernt mit Hilfe von AI-gestützten Algorythmen den Dunst-Effekte (haze) aus Bildern.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

contrast

  • legt fest wie groß der Faktor für den Bild-Kontrast ist
  • gültige Werte: 0.0 - 2.0

brightness

  • legt fest wie groß der Faktor für die Bild-Helligkeit ist
  • gültige Werte: 0 - 100

Step: VanceAIRemoveJPEGArtifacts

Dieser Step verarbeitet ein Spreadsheet mit uid's und entfernt mit Hilfe von AI-gestützten Algorythmen Kompressions-Artefakte aus Bildern.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

deblur

  • auf true gesetzt wird die Bild-Unschärfe entfernt

Step: VanceAIRestorePhotos

Dieser Step verarbeitet ein Spreadsheet mit uid's und entfernt mit Hilfe von AI-gestützten Algorythmen Kompressions-Artefakte aus Bildern.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

with_scratch

  • auf true gesetzt werden Kratzer aus (alten) Fotos entfernt

inpainting

  • auf true gesetzt werden beschädigte Bild-Teile eingesetzt aus ausgebessert

Step: VanceAIColorizePhotos

Dieser Step verarbeitet ein Spreadsheet mit uid's und koloriert mit Hilfe von AI-gestützten Algorythmen schwarz-weiß Fotos.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

module

  • Modul das verwendet werden soll

Optionen:

  • ColorizeStable (colorize) - schneller in der Verarbeitung
  • ColorizeStable_pth (deoldify) - bessere Qualität

render_factor

  • legt die Stärke der Einfärbung fest
  • gültige Werte: 0 - 40

Step: VanceAIRetouchPhotos

Dieser Step verarbeitet ein Spreadsheet mit uid's und Retouchiert Fotos um perfekte Gesichtsporträts mit glatter Haut und weißen Zähnen zu erhalten.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

Step: VancedAIPortraitCartoonizer

Dieser Step verarbeitet ein Spreadsheet mit uid's und wandelt Bilder in Zeichnungen um.

Weitere Informatinen sind in der VanceAI Dokumentationopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

module

  • Modul das verwendet werden soll

Optionen:

  • CartoonizeStable - Cartoon Style Filter
  • Animegan2Stable - Anime Style Filter
  • SketchStable - Sketch Style Filter

single_face

  • wird nur verwendet wenn die Module Animegan2Stable oder SketchStable ausgewählt sind
  • auf true gesetzt wird nur das Gesicht erkannt und transformiert

Step: VanceAIWorkflowCustomizer

Mit diesem Step kann eine benutzerdefinierte Konfiguration angewendet werden. Jeder VanceAI Transformations-Step verwendet intern eine vordefinierte Konfiguration. Hier können verschiedene Transformationen auf die Bilder angewendet werden. Außerdem können Sie hier Bildformat, Auflösung, Hintergrundfarben etc. gesetzt werden.

Einen Konfigurations-Generator ist auf VanceAIopen in new window zu finden.

limit

  • legt fest, wie viele Dateien der Dateiliste verarbeitet werden sollen
  • sinnvoll zu Testzwecken bei einer Dateiliste mit vielen Dateien

uids

  • Spreadsheet mit uid's

webhook

  • Callback-URL welche die Benachrichtigung über das Transfromations-Ergebnis erhalten soll

config

  • als default ist eine Beispielkonfiguration im JSON Format gestzt
  • Konfigurations-Parameter können wieder auf VanceAIopen in new window eingeehen werden

Steps im VanceAI Add-On

Weitere Informationen

Impressum | Datenschutzhinweise
© Synesty GmbH, 2024 - No Code - Low Code Integration Platform - Schnittstellen & API-Anbindungen