agnes-free-video

Agnes Free Video

agnes-video-v2.0 を使用して、非同期の動画生成タスクを作成し、状態を確認するには、このスキルを使用します。

認証情報に関するルール

API キーは環境変数から読み取ってください。プロンプト、スクリプト、スキルファイル、コミット、シェル履歴にキーをハードコードしないでください。

優先する変数：

export AGNES_API_KEY="..."

ヘルパーは、フォールバックとして AGNES_TOKEN も受け付けます。

クイックスタート

テキストから動画を生成：

python3 scripts/agnes_video.py create \
  --prompt "A cinematic shot of a cat walking on the beach at sunset, soft ocean waves, warm golden lighting, realistic motion" \
  --width 1152 \
  --height 768 \
  --num-frames 121 \
  --frame-rate 24 \
  --output-dir ./outputs/agnes-free-video

画像から動画を生成：

python3 scripts/agnes_video.py create \
  --prompt "Animate the product with a slow camera push-in, soft studio reflections, stable identity" \
  --image-url "https://example.com/product.png" \
  --num-frames 121 \
  --frame-rate 24

キーフレーム間の遷移：

python3 scripts/agnes_video.py create \
  --prompt "Create a smooth cinematic transition between the keyframes with natural pacing" \
  --image-url "https://example.com/keyframe1.png" \
  --image-url "https://example.com/keyframe2.png" \
  --mode keyframes \
  --num-frames 121

既存のタスクを確認：

python3 scripts/agnes_video.py status \
  --task-id task_123456 \
  --download \
  --output-dir ./outputs/agnes-free-video

API を呼び出さずにリクエストの形式を検証：

python3 scripts/agnes_video.py create \
  --prompt "A short cinematic AI product teaser, slow dolly shot, clean lighting" \
  --num-frames 81 \
  --dry-run

ワークフロー

1. モードを選択します：テキストから動画、画像から動画、複数画像、またはキーフレームアニメーション。
2. 被写体、動作、シーン、カメラの動き、照明、スタイルを含むプロンプトを作成します。
3. ユーザーが特定の長さを希望している場合を除き、num_frames は 81、121、161、241、または 441 に設定します。
4. scripts/agnes_video.py create を使用してタスクを送信し、状態を確認します。ユーザーがすでにタスク ID を持っている場合は、status を使用します。
5. video_url が表示されたら、速やかに動画をダウンロードします。

注記

• 作成エンドポイント：POST https://apihub.agnes-ai.com/v1/videos
• ステータスエンドポイント：GET https://apihub.agnes-ai.com/v1/videos/{task_id}
• モデル：agnes-video-v2.0
• 動画生成は非同期です。
• num_frames は <= 441 を満たし、かつ 8n + 1 の形式である必要があります。
• ヘルパーのデフォルト設定は 1152x768、121 フレーム、24 FPS です。

リファレンス

リクエストフィールド、タスクのステータス値、エラーコード、モード別のプロンプト例が必要な場合は、references/api.md を参照してください。