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. リクエストを特定する
| ユーザーの発言 | モード |
|---|---|
| "...の絵を作成/描画/生成して" | テキスト→画像 |
| "この画像を編集/変換/スタイル変更して..."（URL提供） | 画像→画像 |
| "...の動画/アニメーション/クリップを作成して" | テキスト→動画 |
| "この写真をアニメーション化/この画像を動かして"（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> 行を出力します。URLは常に独立した行で示してください — 文中に埋め込まないでください。プラットフォームがインラインメディアレンダリングに対応している場合は埋め込み、そうでない場合は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 Unauthorized | APIキーが無効または期限切れです。 |
| 400 Bad Request | プロンプト、サイズ形式、フレームカウントルール（8n+1, ≤441）を確認します。 |
| 503 Service Unavailable | サービスが混雑しています。30秒待ってから再試行します。 |
| 動画タイムアウト（15分） | スクリプトが video_id を出力します — 後で再クエリします。タスクは破棄されていません。 |
完全なAPI動作については references/api_docs.md を参照してください。
リファレンスファイル
references/api_docs.md— 完全なAgnes API仕様references/prompt-guide.md— 画像と動画の両方のプロンプト構造references/parameters.md— すべてのスクリプトパラメータと例