Diese Seite beschreibt die erste Version des Pakets. Zu Version 0.3 mit allen Studios, API-Schlüsseln und Preisfreigabe lesen Sie den neuen Einrichtungsleitfaden.

Der Befehl yesilcam macht die Studios für Skripte zugänglich. Alles, was Sie in der App anklicken, können Sie aus einer Shell ausführen, mit JSON-Ausgabe für das nächste Werkzeug in der Kette. Er nutzt Ihr normales Konto und dieselbe Credit-Wallet, sodass ein Skript und eine Kollegin in der App nie unterschiedliche Guthaben oder unterschiedliche Preise sehen. So nutzen wir ihn, und das sind die paar Regeln, die dafür sorgen, dass automatisierte Produktion Sie nicht überrascht.

Einmal installieren und anmelden

Das Paket heißt yesilcam-studios und wird global mit npm installiert. Führen Sie yesilcam login aus, dann yesilcam balance, um zu prüfen, ob die Wallet sichtbar ist. Das Token wird in ~/.config/yesilcam/config.json mit Berechtigungen nur für den Eigentümer gespeichert; yesilcam logout entfernt es. Halten Sie das Token geheim, denn es gewährt vollen Zugriff auf das Konto, und committen Sie die Konfigurationsdatei nirgendwohin.

Die Befehle, die Sie tatsächlich nutzen werden

  • yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.png erzeugt ein Bild auf einer Stufe und speichert es.
  • yesilcam video --from 1234 --duration 5 --wait animiert ein vorhandenes Asset und wartet auf das Ergebnis.
  • yesilcam tryon --garment 88 --person 77 --out look.png führt ein Try-on für ein Kleidungsstück-Asset an einem Model aus.
  • yesilcam assets upload file.png legt eine Datei in Ihrer Bibliothek ab und gibt ihre ID zurück.
  • yesilcam maket analyze plan.dxf meldet, was ein Grundriss enthält; yesilcam maket create "Villa" und yesilcam maket save ground.dxf --project 12 --floor 0 legen Pläne in Projekten ab.

Hängen Sie an jeden davon --json an, um maschinenlesbare Ausgabe zu erhalten. Dieses Flag ist der eigentliche Sinn der CLI: Es macht jedes Studio zu einem Schritt in einer Pipeline, die Ihnen gehört.

Ein nächtlicher Katalog

Die Schleife, die wir für einen Modekunden laufen lassen, sieht so aus: Für jedes Produktfoto in einem Ordner wird es mit yesilcam --json assets upload hochgeladen, die Asset-ID aus dem JSON gelesen und dann yesilcam --json tryon mit dieser Kleidungsstück-ID und der Model-ID ausgeführt, mit --wait und einem Ausgabepfad, der nach der Datei des Kleidungsstücks benannt ist. Am Morgen ist aus einem Ordner voller Produktfotos ein Ordner voller Looks geworden, jeder mit seiner Herkunft im Protokoll unter denselben Auftrags-IDs, die das JSON ausgegeben hat. Neue Farbvarianten landen im Ordner und werden in der nächsten Nacht verarbeitet, ohne dass jemand die App öffnet.

Storyboards aus einem Skript

Zerlegen Sie ein Drehbuch in Szenen-Prompts, einen pro Zeile, und lassen Sie yesilcam image darüber auf der Draft-Stufe mit nummerierten Ausgabedateien laufen. Sichten Sie den Ordner als Bildstreifen. Wiederholen Sie dann nur die guten Bilder auf der Standardstufe. Der Draft-Durchlauf kostet einen Bruchteil des Standarddurchlaufs, und die Sichtung passiert in einem Dateibrowser statt in einer Warteschlange, und so sehen wir uns dreißig Bilder auf einmal am liebsten an.

Grundrissprüfungen in der CI

yesilcam maket analyze plan.dxf --json gibt Wände, Türen, Fenster und Räume zurück. Lassen Sie den Build scheitern, wenn ein Plan keine Räume hat oder seine Einheiten geschätzt wurden. Ein Architekturbüro, das DXFs aus einer Vorlage exportiert, kann ein kaputtes Layer-Schema abfangen, bevor jemand die Datei vor einem Bauherrn öffnet, und die Prüfung dauert eine Sekunde.

Regeln, die Skripte ehrlich halten

  1. Führen Sie Aufträge nacheinander aus, wenn Sie ihre IDs in Reihenfolge brauchen. Die Warteschlange wird mit der App geteilt; ein Skript, das zwanzig Aufträge parallel abfeuert, bekommt sie in der Reihenfolge zurück, in der sie fertig werden.
  2. Prüfen Sie zuerst das Guthaben. yesilcam balance --json vor einem Stapel, und abbrechen, wenn es knapp ist. Ein Skript, das die Wallet um drei Uhr nachts leerläuft, ist ein Skript, das einen halben Stapel scheitern lässt.
  3. Nutzen Sie die Draft-Stufe für alles, was Sie vor dem Behalten ansehen. Automatisierung macht es leicht, standardmäßig auf der Standardstufe auszugeben. Tun Sie das nicht.
  4. Bewahren Sie die Auftrags-IDs auf. Über sie finden Sie das Asset in der Bibliothek, über sie erklärt das Protokoll eine Abbuchung, und über sie wird eine Erstattung nachverfolgt, wenn ein Auftrag gescheitert ist.
  5. Parsen Sie keine menschenlesbare Ausgabe. Immer --json. Das menschenlesbare Format ist für die Augen gedacht und kann sich ändern.

Was die CLI nicht tut

Sie umgeht weder die Preise noch die Wallet; jeder Vorgang kostet, was er in der App kostet, mit Ihrem Planmultiplikator. Sie führt nicht die 3D-Konvertierung von Maket aus, die im Browser stattfindet; sie analysiert Pläne und legt sie ab. Und sie wiederholt gescheiterte Aufträge nicht für Sie. Fehlschläge werden automatisch erstattet, und das JSON sagt Ihnen, welcher Auftrag gescheitert ist, aber die Entscheidung, ihn erneut zu starten, liegt bei Ihnen.

Häufige Fragen

Können sich zwei Personen ein CLI-Token teilen? Sie sollten es nicht. Das Token gewährt vollen Zugriff auf das Konto, von dem es stammt. Jede Person meldet sich mit ihrem eigenen Konto an, und die Wallet, aus der sie ausgibt, ist ihre eigene.

Sieht ein Skript dieselben Preise wie die App? Ja. Die CLI, die App, die MCP-Werkzeuge und die Preisseite lesen dieselbe Live-Tabelle, es gibt also überall einen Preis pro Vorgang.

Wohin gehen die Ergebnisse? In Ihre Bibliothek, genau wie aus der App, und an den Pfad, den Sie mit --out angeben. Nichts, was ein Skript erzeugt, bleibt der App verborgen.