VisionCraft
Generieren Sie Bilder und Videos über die Agnes AI APIs. Ruft PowerShell-Skripte in scripts/ auf. Der API-Schlüssel wird aus der Umgebungsvariable AGNES_API_KEY gelesen.
Zum ersten Mal? Siehe Voraussetzungen. Für Tipps zur Eingabeaufforderung und Parameterdetails siehe
references/.
Kurzreferenz
| Aufgabe | Befehl |
|---|---|
| Text-zu-Bild | scripts/gen_image.ps1 -Prompt "..." |
| Bild-zu-Bild | scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..." |
| Text-zu-Video | scripts/gen_video.ps1 -Prompt "..." |
| Bild-zu-Video | scripts/gen_video.ps1 -Prompt "..." -Image "https://..." |
| Multi-Bild Video | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" |
| Keyframes-Animation | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes |
Standardwerte: Bilder 2048x2048. Videos 1920x1080 @ 60fps, 241 Frames (~4s).
Voraussetzungen
Setzen Sie den API-Schlüssel einmalig (bleibt für Sitzungen erhalten):
[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-your-key-here", "User")
Oder nur für die aktuelle Sitzung:
$env:AGNES_API_KEY = "sk-your-key-here"
Überprüfen mit echo $env:AGNES_API_KEY.
Verwendung dieses Skills
1. Anfrage identifizieren
| Benutzer sagt | Modus |
|---|---|
| "make/draw/generate a picture of..." | Text-zu-Bild |
| "edit/transform/restyle this image..." (URL angegeben) | Bild-zu-Bild |
| "make a video / animate / generate a clip of..." | Text-zu-Video |
| "animate this photo / make this image move" (1 Bild) | Bild-zu-Video |
| "blend these images into a video" (mehrere Bilder) | Multi-Bild Video |
| "smooth transition / morph from A to B" (2+ Bilder) | Keyframes-Animation |
2. Eingabeaufforderung ggf. verfeinern
Falls die Anfrage vage ist, schlagen Sie kurz eine präzisere Eingabeaufforderung vor. Hinweise zur Struktur und Best Practices finden Sie in references/prompt-guide.md.
3. Skript ausführen
Übergeben Sie das Seitenverhältnis mit -Ratio und die Dauer mit -Seconds für die einfachste Steuerung. Alle Parameter finden Sie in references/parameters.md.
# Beispiele:
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8
4. Ergebnis anzeigen
Die Skripte geben bei Erfolg eine Zeile MEDIA:<url> aus. Geben Sie die URL immer in einer eigenen Zeile aus – niemals in einem Absatz. Wenn die Plattform integrierte Medienwiedergabe unterstützt, betten Sie sie ein; andernfalls reicht die URL allein.
Laden Sie das Ergebnis niemals auf die lokale Festplatte herunter, es sei denn, der Benutzer fordert es ausdrücklich.
Ausgabeformat
Bild:
✅ Bild generiert.
MEDIA:https://platform-outputs.agnes-ai.space/images/...
Video:
🎬 Video generiert (4.0s, 1920x1080).
MEDIA:https://platform-outputs.agnes-ai.space/videos/...
Fehler & Problemlösung
| Fehler | Behebung |
|---|---|
AGNES_API_KEY nicht gesetzt | Setzen Sie den Schlüssel (siehe Voraussetzungen). Terminal ggf. neu starten. |
| 401 Nicht autorisiert | API-Schlüssel ungültig oder abgelaufen. |
| 400 Ungültige Anfrage | Überprüfen Sie Eingabeaufforderung, Größenformat, Frame-Anzahl (8n+1, ≤441). |
| 503 Dienst nicht verfügbar | Dienst ausgelastet. 30s warten, erneut versuchen. |
| Video-Zeitüberschreitung (15 Min) | Skript gibt die video_id aus – später erneut abfragen, der Vorgang wird nicht aufgegeben. |
Vollständiges API-Verhalten siehe references/api_docs.md.
Referenzdateien
references/api_docs.md– vollständige Agnes API-Spezifikationreferences/prompt-guide.md– Struktur für Bild- und Video-Eingabeaufforderungenreferences/parameters.md– alle Skript-Parameter mit Beispielen