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.
Das npm-Paket yesilcam-studios liefert zwei Befehle. yesilcam ist die Kommandozeilenschnittstelle: Alles, was Sie in der App anklicken, können Sie auch aus einer Shell ausführen, mit JSON-Ausgabe für das nächste Werkzeug in der Kette. yesilcam-mcp ist ein Model-Context-Protocol-Server, über den Claude die Studios als Werkzeuge bedienen kann. Beide nutzen Ihr normales Konto und Ihre normale Credit-Wallet, sodass ein Skript und eine Kollegin in der App nie kollidieren: Sie teilen sich dieselbe Warteschlange und dasselbe Guthaben. Dieser Leitfaden behandelt Installation, Anmeldung, die wichtigsten Befehle, die MCP-Einrichtung und die Gewohnheiten, die Automatisierung sicher halten.
Installieren und anmelden
- Global installieren:
npm install -g yesilcam-studios. - Einmal anmelden:
yesilcam login. Der Befehl fragt nach Ihren Zugangsdaten und speichert ein Zugriffstoken. - Prüfen, ob es geklappt hat:
yesilcam balancegibt Ihr Credit-Guthaben aus.
Das Token wird mit Dateirechten nur für den Besitzer in ~/.config/yesilcam/config.json gespeichert. Mit yesilcam logout entfernen Sie es, etwa bevor Sie einen Rechner weitergeben. Das Token gewährt vollen Zugriff auf das Konto, einschließlich des Ausgebens von Credits; behandeln Sie es also wie ein Passwort: Committen Sie es nicht, fügen Sie es nicht in geteilte Chats ein, und ersetzen Sie es durch Ab- und erneutes Anmelden, falls es möglicherweise offengelegt wurde.
Aus dem Terminal generieren
yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.pngerzeugt ein Bild auf der Standardstufe und speichert es.yesilcam video --from 1234 --duration 5 --waitstartet einen Fünf-Sekunden-Clip aus Bild 1234 und wartet, bis er fertig ist.yesilcam tryon --garment 88 --person 77 --out look.pngführt eine Anprobe mit einem Kleidungsstück-Asset und einem Model aus.yesilcam maket analyze plan.dxfliest einen Grundriss und meldet Wände, Türen, Fenster und Räume.yesilcam maket create "Villa",yesilcam maket save ground.dxf --project 12 --floor 0undyesilcam maket plans 12bilden das Projekt- und Planmodell der App ab.
Ergänzen Sie --json an jedem Befehl für maschinenlesbare Ausgabe; die zurückgegebenen IDs übergeben Sie an den nächsten Befehl. --wait blockiert, bis der Auftrag fertig ist, statt sofort mit einer Auftrags-ID zurückzukehren. Jeder Auftrag kostet genau so viel wie in der App, mit angewandtem Planmultiplikator, und fehlgeschlagene Aufträge werden auf dieselbe Weise erstattet.
Muster für Skripte
- Ein nächtlicher Katalog. Durchlaufen Sie einen Ordner mit Fotos von Kleidungsstücken: Laden Sie jedes mit
yesilcam --json assets uploadhoch, lesen Sie die Asset-ID aus und führen Sie dannyesilcam --json tryonmit--waitund--outaus. Aus vierzig Kleidungsstücken werden vierzig Looks, während Sie schlafen. - Storyboards aus einem Skript. Zerlegen Sie ein Drehbuch in Szenen-Prompts und lassen Sie
yesilcam imageauf der Draft-Stufe in einer Schleife in einen Ordner schreiben. Prüfen Sie den Ordner und führen Sie dann nur die gelungenen Bilder erneut auf Standard aus. - Planprüfungen in der CI.
yesilcam maket analyze plan.dxf --jsonliefert die erkannten Wände, Türen, Fenster und Räume. Lassen Sie den Build fehlschlagen, wenn ein Plan keine Räume hat oder seine Einheiten geschätzt werden mussten.
Eine Regel: Führen Sie Aufträge nacheinander statt parallel aus, wenn Sie ihre IDs in der richtigen Reihenfolge brauchen. Parallele Läufe sind für unabhängige Arbeiten in Ordnung, aber ein Skript, das davon ausgeht, dass Auftrag 2 nach Auftrag 1 angelegt wurde, muss sie nacheinander einreichen.
Claude verbinden
Der MCP-Server stellt die Studios als Werkzeuge bereit: Bild und Video erzeugen, eine Anprobe ausführen, den Auftragsstatus prüfen, Assets der Bibliothek auflisten, Charaktere auflisten, das Guthaben lesen, Preise nennen und Maket-Pläne analysieren oder speichern. Die Einrichtung braucht zwei Befehle.
- Token ausgeben:
yesilcam login --jsonund das Feldtokenkopieren. - Server bei Claude Code registrieren:
claude mcp add yesilcam -e YESILCAM_TOKEN=<token> -- yesilcam-mcp.
Claude Desktop liest denselben Server aus seiner Konfigurationsdatei; yesilcam mcp gibt den dort einzufügenden Ausschnitt aus. Sobald die Verbindung steht, beschreiben Sie das gewünschte Ergebnis, und Claude ordnet die Aufrufe: „Erstelle für diese sechs Szenen ein Storyboard auf Draft, zeig mir die Bilder und produziere dann die zwei, die ich auswähle, auf Standard.“ Claude legt die Aufträge an, wartet, liefert die URLs zurück und kann, da das Preiswerkzeug verfügbar ist, die Kosten nennen, bevor etwas ausgelöst wird.
Einen Menschen in der Schleife behalten
Draft-Arbeit darf autonom laufen. Produktionen auf Standard- und Cinema-Stufe sollten auf Ihr ausdrückliches Ja warten, denn dort fließen die Credits hin. Sagen Sie das in Ihren Anweisungen („frag vor jedem Auftrag oberhalb von Draft“), und Claude wird fragen. Für Skripte gilt dasselbe: Legen Sie die Stufe in einer Variablen ab, setzen Sie den Standardwert auf Draft und machen Sie die höheren Stufen zu einem ausdrücklichen Flag. Prüfen Sie das Guthaben vor einem langen Stapel und denken Sie daran, dass die Wallet mit der App geteilt wird: Eine Kollegin, die gleichzeitig einen Film produziert, zehrt von denselben Credits.
Fehlerbehebung
- Befehl nicht gefunden. Das Verzeichnis, in das npm globale Programme legt, ist nicht in Ihrem PATH. Fügen Sie es hinzu und öffnen Sie eine neue Shell.
- Nicht autorisiert. Das gespeicherte Token wurde entfernt oder die Konfigurationsdatei gelöscht. Führen Sie
yesilcam loginerneut aus. - Der MCP-Server erscheint nicht. Der Name der Umgebungsvariable lautet
YESILCAM_TOKEN, und ihr Wert ist das Token ausyesilcam login --json, nicht Ihr Passwort. Starten Sie den Client nach dem Hinzufügen des Servers neu. - Ein Auftrag liefert keine Ausgabe. Prüfen Sie seinen Status; ein fehlgeschlagener Auftrag wird erstattet und kann erneut eingereicht werden.
Häufige Fragen
Kostet die CLI extra? Nein. Sie nutzt dieselbe Credit-Wallet und dieselben Preise wie die App.
Wo wird das Token gespeichert? In ~/.config/yesilcam/config.json, lesbar nur für Ihren Benutzer. yesilcam logout löscht es.
Kann Claude Credits ausgeben, ohne zu fragen? Nur wenn Sie es zulassen. Jedes Werkzeug meldet den Auftrag und seinen Status, mit dem Preiswerkzeug kann Claude vorab die Kosten nennen, und eine Anweisung, vor Stufen oberhalb von Draft zu fragen, wird beachtet.
Kann ich CLI und App gleichzeitig nutzen? Ja. Aufträge aus beiden erscheinen in derselben Warteschlange und derselben Bibliothek.
