哪都通图生视频 (Antigravity)

Was macht 哪都通图生视频 (Antigravity)?

Verwenden Sie den eigenständigen Python-Client dieser Fähigkeit, um Videokandidaten zu generieren. Das Standardmodell ist das getestete seedance-2.5; der Workflow ist nicht von einem bestimmten Projekt, anderen Arbeitsbäumen oder dem Bereitstellungsstatus abhängig.

Lokale Konfiguration und Ausführungseinstieg

• Einheitlicher Berechtigungsnachweis ist NXTPATH_API_KEY, standardmäßig aus der Umgebungsvariable oder ~/.config/nxtpath/env gelesen. Die Umgebungsvariable hat Vorrang; NXTPATH_ENV_FILE kann eine andere private Konfiguration angeben. Lesen Sie keine anderen Chat-Tokens der Anwendung und legen Sie keine Schlüssel in Befehlszeilen, Skills, Berichte oder Aufgabenaufzeichnungen offen.
• Neue zsh-Prozesse laden die lokale Konfiguration über ~/.zshenv; wenn GUI oder alte Prozesse die Umgebung nicht geerbt haben, kann der Client die genannten Dateien dennoch direkt lesen. Es wird nur gemeldet, ob die Konfiguration existiert, der Inhalt wird nicht angezeigt.
• Suchen Sie scripts/nxtpath_video.py im aktuell geladenen Skill-Verzeichnis. Verwenden Sie bevorzugt ~/.config/nxtpath/venv/bin/python; falls nicht vorhanden, können HTTPS-Referenzbilder und die Video-API direkt mit Python 3.9+ ausgeführt werden. Lokales Bild-Hosting erfordert außerdem boto3 aus scripts/requirements.txt.
• Lesen Sie im Zielprojekt zunächst die geltenden Ressourcen- und Datenschutzbestimmungen. Aufgaben werden standardmäßig im ignorierten Verzeichnis tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/ des Projekts abgelegt; wenn kein Projekt vorhanden ist, verwenden Sie das vom Benutzer gewählte Ausgabeverzeichnis. Überschreiben Sie keinen alten Versuch und fügen Sie Kandidaten nicht automatisch in Builds oder offizielle Ressourcen ein.

Einmalige Erstellung oder Wiederaufnahme einer vorhandenen Aufgabe

Wenn der Benutzer ausdrücklich die Generierung eines bestimmten Videos angefordert hat, führen Sie einen Kandidaten gemäß dieser Anfrage durch, ohne erneut um eine allgemeine Bestätigung zu bitten. Nur Fragen zu Route, Konfiguration oder Skill-Nutzung autorisieren keine kostenpflichtige Generierung. Stückzahl, Anzahl der Nacharbeiten und Kostenrahmen entsprechen den vom Benutzer für diesen Vorgang vereinbarten Bedingungen; falls nicht vereinbart, erstellen Sie zuerst einen Eintrag, ohne automatisch zu erweitern oder fehlgeschlagene Aufgaben erneut zu generieren.

1. Führen Sie doctor --check-api mit run_command aus, um Anmeldeinformationen und verfügbare Modelle zu überprüfen. Dies ist eine schreibgeschützte Anfrage und generiert kein Video.
2. Bestätigen Sie Referenzbild und Aktionsbeschreibung (lokales Referenzbild zuerst mit read_file anzeigen). Klären Sie Aktionsphase, Kameraeinstellung, Komposition, Dauer sowie zu erhaltende Charaktere und Requisiten; nicht näher bezeichnete Entwürfe sind standardmäßig 4 Sekunden / 480p, und behandeln Sie einen standardmäßigen Low-Res-Entwurf nicht als offizielles Endergebnis. Native Bildrate, Charakterkonsistenz, Start- und Endpose sowie Transparenz richten sich nach dem tatsächlichen Video.
3. Speichern Sie die Aufforderung als UTF-8-Datei und verwenden Sie prepare, um eine unveränderliche Eingabe zu erstellen. --reference kann wiederholt für lokale PNG/JPEG/WebP- oder HTTPS-Bild-URLs übergeben werden; dies sind gewöhnliche Leitbilder, die nicht vorgeben können, dass die API Start- und End-Keyframes festlegt. Text-zu-Video kann ohne Referenzbild auskommen.
4. Wenn lokale Bilder vorhanden sind, führen Sie host aus, um den Eingabe-Snapshot in einen konfigurierten privaten R2-Bucket hochzuladen oder wiederzuverwenden, ein 24-Stunden-GET zu signieren und den Download-Hash zu überprüfen. Dieser Vorgang übergibt das Referenzbild an den Hosting-Dienst und den Videoanbieter; dies sollte innerhalb des vom Benutzer angeforderten Materials erfolgen. Wenn das Hosting fehlschlägt, reichen Sie kein Video ein, und wechseln Sie nicht automatisch das Konto, den öffentlichen Bucket oder den Dienst. Für vorhandene HTTPS-Referenzbilder ist kein host erforderlich.
5. Führen Sie submit nur einmal aus. Es persistiert zunächst einen exklusiven Einreichungsdatensatz und sendet dann eine kostenpflichtige POST-Anfrage. Verwenden Sie anschließend das separate status zur Abfrage und nach Erfolg download, um video.mp4 zu erhalten; jeder Befehl wird unabhängig über run_command ausgeführt. Stecken Sie kein minutenlanges Polling in einen einzigen langen Shell-Aufruf und verwenden Sie niemals sleep in der Shell als Timer. Wenn gewartet werden muss, setzen Sie mit schedule(DurationSeconds=...) einen einmaligen Timer, beenden Sie die aktuelle Runde, und führen Sie dann status erneut aus. Bei Zeitüberschreitung darf die Generierungsanfrage nicht wiederholt werden.
6. Verwenden Sie bei der Wiederherstellung über mehrere Dialoge hinweg den ursprünglichen Job-Pfad, führen Sie zuerst inspect aus, dann status / download. Für Versuche mit vorhandener Einreichung, unbekanntem Ergebnis oder ohne Aufgaben-ID darf POST nicht wiederholt werden; wenn keine Aufgaben-ID vorhanden ist, gleichen Sie mit dem Anbieter auf Basis des privaten Einreichungsdatensatzes ab. Bei fehlgeschlagenem Download nur den Download wiederholen. Bei 401/403, unzureichendem Kontingent oder nicht verfügbarem Modell die Einreichung stoppen, Grund melden, nicht automatisch Schlüssel, Modell oder Schnittstelle wechseln.

Befehlsbeispiel (CLIENT bezieht sich auf das Skript im eigentlichen Skill; PY auf das lokale Python; JOB auf das neu erstellte Aufgabenverzeichnis):

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --reference "$REFERENCE_IMAGE" --duration 4 --resolution 480p --ratio 1:1
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

Lieferung und Grenzen

Liefern Sie das abspielbare lokale Video und den Job-Pfad, zeigen Sie das Video mit dem Link [video.mp4](file:///absolute/path/to/video.mp4) an, und erläutern Sie, dass es sich um einen Kandidaten handelt sowie die tatsächlich geprüften Inhalte. Wenn das fertige Video begutachtet werden muss, verwenden Sie direkt das Antigravity-read_file-Tool, um die heruntergeladene video.mp4 zu lesen (native Unterstützung für multimodales Video-Lesen), und überprüfen Sie Originalgeschwindigkeit, Schlüsselaktionen sowie Start- und Endpose. Ein erfolgreicher HTTP-Status ist nicht gleichbedeutend mit bestandenen Bewegungen oder der Kunst.

Der Aufgabenaufzeichnung umfasst Aufforderung, Eingabe-Snapshot, genaue Anfrage, Aufgaben-Handle des Anbieters, Ergebnis und Datei-Hash; Berechtigungen sind standardmäßig nur für den aktuellen Benutzer lesbar. Diese Aufzeichnungen können temporäre signierte URLs enthalten; sie dürfen nicht vollständig in den Chat oder in Git Commits eingefügt werden. Auf der Konsole wird nur der Fingerabdruck des Aufgaben-Handles angezeigt. Transparente Hintergründe, SVG-Übergänge und App-Integration sind nachgelagerte Arbeiten, die gemäß den Werkzeugen und Berechtigungen des Zielprojekts behandelt werden.

Lesen Sie Konfiguration und Fehlerbehebung nur, wenn Sie das Gerät wechseln, Anmeldeinformationen aktualisieren oder das Hosting fehlschlägt. Die API-Spezifikation finden Sie im Seedance Skill des Anbieters.