VisionCraft
透過 Agnes AI API 生成圖像與影片。它會呼叫 scripts/ 中的 PowerShell 腳本。API 金鑰從環境變數 AGNES_API_KEY 讀取。
第一次使用？ 請參考先決條件。如需提示詞撰寫技巧與參數詳細資訊，請參閱
references/。
快速參考
| 任務 | 指令 |
|---|---|
| 文字轉圖像 | scripts/gen_image.ps1 -Prompt "..." |
| 圖像轉圖像 | scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..." |
| 文字轉影片 | scripts/gen_video.ps1 -Prompt "..." |
| 圖像轉影片 | scripts/gen_video.ps1 -Prompt "..." -Image "https://..." |
| 多重圖像影片 | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" |
| 關鍵影格動畫 | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes |
預設值： 圖像 2048x2048。影片 1920x1080 @ 60fps, 241 幀（約 4 秒）。
先決條件
設定 API 金鑰（一次設定，跨工作階段持久保存）：
[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-your-key-here", "User")
或僅限目前工作階段：
$env:AGNES_API_KEY = "sk-your-key-here"
驗證方式：echo $env:AGNES_API_KEY。
如何使用此技能
1. 識別請求
| 使用者說法 | 模式 |
|---|---|
| "製作/繪製/生成一張...的圖片" | 文字轉圖像 |
| "編輯/變換/重新風格化這張圖片..."（附網址） | 圖像轉圖像 |
| "製作一部影片 / 動畫 / 生成一個...的剪輯" | 文字轉影片 |
| "將這張照片動畫化 / 讓這張圖片動起來"（1 張圖片） | 圖像轉影片 |
| "將這些圖片混合成一部影片"（多張圖片） | 多重圖像影片 |
| "從 A 到 B 的平滑過渡 / 變形"（2 張以上圖片） | 關鍵影格動畫 |
2. 必要時潤飾提示詞
如果請求不夠明確，請在執行前簡短建議更豐富的提示詞。提示詞結構與最佳實務請參閱 references/prompt-guide.md。
3. 執行腳本
使用 -Ratio 傳遞長寬比，使用 -Seconds 傳遞持續時間，以獲得最簡單的控制。所有參數請參閱 references/parameters.md。
# 範例：
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8
4. 顯示結果
腳本成功時會輸出一行 MEDIA:<url>。務必將網址單獨一行顯示 — 絕不要將其埋藏在段落中。如果平台支援內嵌媒體渲染，請嵌入；否則僅提供網址即可。
除非使用者明確要求，否則絕不要將結果下載到本地磁碟。
輸出格式
圖像：
✅ 圖像已生成。
MEDIA:https://platform-outputs.agnes-ai.space/images/...
影片：
🎬 影片已生成（4.0 秒，1920x1080）。
MEDIA:https://platform-outputs.agnes-ai.space/videos/...
錯誤與疑難排解
| 錯誤 | 解決方案 |
|---|---|
AGNES_API_KEY not set | 設定它（請參閱先決條件）。必要時重新啟動終端機。 |
| 401 未經授權 | API 金鑰無效或已過期。 |
| 400 錯誤請求 | 檢查提示詞、尺寸格式、影格數規則（8n+1，≤441）。 |
| 503 服務無法使用 | 服務忙碌中。等待 30 秒後重試。 |
| 影片逾時（15 分鐘） | 腳本會輸出 video_id — 稍後重新查詢，任務仍在進行中。 |
完整的 API 行為請參閱 references/api_docs.md。
參考檔案
references/api_docs.md— 完整的 Agnes API 規格references/prompt-guide.md— 適用於圖像與影片的提示詞結構references/parameters.md— 每個腳本參數及其範例