Wer einem KI-Assistenten oder einem Skript Zugriff auf einen kostenpflichtigen Dienst gibt, stellt sich zu Recht zwei Fragen: Was hält ihn davon ab, ohne Rückfrage Geld auszugeben, und was passiert, wenn der Schlüssel in falsche Hände gerät? Die CLI und der MCP-Server von Yeşilçam Studios beantworten beides mit demselben Prinzip. Jede Operation, die Tokens verbraucht, nennt zuerst einen Preis und bucht nichts ab, und jeder API-Schlüssel ist in seinen Möglichkeiten begrenzt. Dieser Leitfaden erklärt beides, damit Sie entscheiden können, wie viel Freiheit Sie Ihrem Assistenten lassen. Die Installation beschreibt der Einrichtungsleitfaden.

Warum liefert jedes kostenpflichtige Werkzeug zuerst ein Angebot?

Werkzeuge, die Tokens verbrauchen, buchen beim ersten Aufruf nie etwas ab. Sie liefern ein Angebot mit der Kennzeichnung quote_only_nothing_charged, mit den einzelnen Posten, der Summe, Ihrem aktuellen Guthaben und der Angabe, ob es dafür reicht. Der Assistent ist angewiesen, Ihnen diesen Preis zu zeigen und nachzufragen. Erst wenn Sie zustimmen, ruft er dasselbe Werkzeug erneut mit confirm=true auf, und erst dann startet die Arbeit und die Tokens werden abgezogen.

In der Praxis sieht das so aus: Sie bitten um ein Entwurfsbild, der Assistent antwortet mit dem Preis und Ihrem Guthaben, Sie sagen Ja, und er erstellt das Bild. Sagen Sie Nein, wurde nichts ausgegeben.

Monatliche Freinutzungen eines kostenpflichtigen Tarifs erscheinen im Angebot mit 0 Tokens und verlangen trotzdem eine Freigabe, weil sie ein Kontingent aufbrauchen.

Wie funktionieren Freigaben im Terminal?

Starten Sie einen kostenpflichtigen Befehl ohne weitere Optionen, zeigt die CLI das Angebot und fragt Spend about … tokens? [y/N]. Mit y geht es weiter. Für Skripte gibt es drei Möglichkeiten:

  • --yes gibt den angebotenen Preis ohne Rückfrage frei.
  • --max-tokens <n> lehnt den Auftrag ab, wenn das Angebot über n liegt, auch zusammen mit --yes. Nutzen Sie diese Option in jedem Skript als Sicherheitsgrenze.
  • --quote zeigt nur den Preis an und beendet sich.

Gibt es kein interaktives Terminal oder verwenden Sie --json, gibt ein kostenpflichtiger Befehl ohne --yes das Angebot aus, bucht nichts ab und endet mit dem Exit-Code 3. Ein Skript kann „Angebot gezeigt, nicht freigegeben“ also von einem fertigen Auftrag unterscheiden. Exit-Code 2 bedeutet, dass Sie nicht angemeldet sind.

yesilcam video create "ocean waves at sunset" --tier draft --duration 5 --quote
yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --aspect 16:9 --max-tokens 50000 --yes --out lighthouse.png

Für den Assistenten gilt dieselbe Grenze: Bitten Sie ihn, unter einer bestimmten Zahl von Tokens zu bleiben, übergibt er max_tokens, und das Werkzeug lehnt alles Teurere ab.

Wie sehen Preise und Erstattungen aus?

Die Preise sind dieselben wie in der App, mit Ihrem Tarif verrechnet, und fehlgeschlagene Aufträge werden automatisch erstattet. yesilcam account pricing listet die Token-Preise aller Operationen auf, yesilcam account price nennt den genauen Preis einer Operation in Ihrem Tarif. Zwei Funktionen haben eigene Regeln:

  • Lange Videos werden während der Produktion Kapitel für Kapitel abgerechnet. Gehen die Tokens aus, pausiert die Produktion, und Sie setzen sie mit longvideo resume fort.
  • Automatisierungen werden mit einer monatlichen Obergrenze gespeichert. Mit der Freigabe einer Automatisierung genehmigen Sie Ausgaben bis zu dieser Grenze, und sie wird nie überschritten.

Nur lesen oder Lesen und erstellen?

Beim Erstellen eines Schlüssels unter Konto → Entwickler wählen Sie seine Berechtigung. Ein Schlüssel mit Nur lesen sieht Ihr Konto, Guthaben, Preise, Ihre Bibliothek und den Status Ihrer Aufträge und kann Ergebnisse herunterladen. Er kann nichts erstellen, bearbeiten, löschen oder ausgeben. Ein Schlüssel mit Lesen und erstellen kann zusätzlich Arbeiten starten und Tokens verbrauchen, immer über Angebot und Freigabe.

Der MCP-Server hat einen eigenen Schalter: Mit --read-only gestartet, lädt er nur lesende Werkzeuge, selbst wenn der Schlüssel mehr dürfte. Verwenden Sie einen Schlüssel mit Leserecht für Berichtsskripte und Dashboards und einen Schlüssel mit Erstellrecht nur dort, wo tatsächlich etwas produziert werden soll.

Was kann ein API-Schlüssel nie?

Manche Aktionen bleiben unabhängig von der Berechtigung in der Web-App:

  • das Konto löschen oder dessen Passwort oder E-Mail-Adresse ändern;
  • bezahlen, Tokens oder Tarife kaufen oder automatische Aufladungen für Automatisierungen einschalten;
  • API-Schlüssel erstellen oder widerrufen;
  • Social-Media-Konten verbinden.

Ein abhandengekommener Schlüssel kann also höchstens die Tokens ausgeben, die bereits in Ihrem Guthaben sind, und das nur über dieselben Angebote. Er kann Sie weder aussperren noch Nachschub kaufen.

Wie werden Schlüssel gespeichert, und wie widerrufe ich einen?

Auf Ihrem Computer liegt der Schlüssel in ~/.config/yesilcam/config.json, nur für Ihren Benutzer lesbar, und er wird nie angezeigt. Bei uns wird nur ein sicherer Fingerabdruck des Schlüssels gespeichert, nicht der Schlüssel selbst; deshalb sehen Sie ihn nur einmal. Jeder Schlüssel kann nach 30, 90 oder 365 Tagen ablaufen oder unbegrenzt gültig sein. Könnte ein Schlüssel in falsche Hände geraten sein, widerrufen Sie ihn unter Konto → Entwickler und erstellen Sie einen neuen. yesilcam logout entfernt den Schlüssel nur von einem Computer; der Schlüssel selbst bleibt gültig, bis er abläuft oder widerrufen wird.

Wie steht es um Datenschutz und Sicherheit?

  • Ihre Medien sind privat. Links zu Ihren Dateien sind signiert und laufen nach einigen Stunden ab; ein Download über die Werkzeuge erneuert sie. Ein öffentlicher Link oder ein Beitrag auf The Wall läuft über eine Freigabeanfrage, die gegebenenfalls genehmigt werden muss.
  • Personen und Figuren. Figuren sind immer erwachsen, reale Personen des öffentlichen Lebens sind nicht erlaubt. Ihr eigenes Foto oder Video wird nur mit ausdrücklicher Einwilligung (photo_consent, video_consent) und nach einer Sicherheitsprüfung verwendet.
  • Tarife. Manche Funktionen setzen Basic oder Pro voraus, etwa die Cinema-Stufen, Story to Film und Flow (Pro), Videos über 30 Sekunden (Basic) oder über 60 Sekunden (Pro) und Automatisierungen (Basic). Die Werkzeuge sagen das in klaren Worten.

Gute Gewohnheiten mit einem Assistenten

  • Nennen Sie zu Beginn Ihr Budget: „Frag mich vor allem, was über 100.000 Tokens kostet.“
  • Probieren Sie in der Entwurfsstufe aus und produzieren Sie die gelungenen Varianten danach in einer höheren Stufe.
  • Lassen Sie sich zu Beginn und am Ende einer Sitzung das Guthaben nennen.
  • Geben Sie jedem Computer und jedem Server einen eigenen Schlüssel mit der kürzesten praktikablen Gültigkeit, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.

Häufige Fragen

Kann der Assistent ein Angebot selbst freigeben? Die Werkzeuge sind so gebaut, dass er erneut mit Freigabe aufrufen muss, und der Server weist ihn an, Sie vorher zu fragen. Halten Sie bei allem, was Tokens kostet, eine menschliche Antwort im Ablauf, und verwenden Sie einen Schlüssel mit Leserecht, wo nichts ausgegeben werden soll.

Warum verlangt eine monatliche Freinutzung trotzdem eine Freigabe? Weil sie einen Teil des Kontingents Ihres Tarifs aufbraucht. Das Angebot zeigt 0 Tokens, damit Sie wissen, dass von Ihrem Guthaben nichts abgezogen wird.

Kann ein Schlüssel Tokens kaufen, wenn mein Guthaben aufgebraucht ist? Nein. Tokens, Tarife und automatische Aufladungen lassen sich nur in der Web-App kaufen bzw. einrichten.