메뉴
Generate text, images, and video from the CLI via the Vercel AI Gateway (one key, hundreds of models).
| name | ai-gateway |
| description | Generate text, images, and video from the CLI via the Vercel AI Gateway (one key, hundreds of models). |
| allowed-tools | ["Bash(ai-gateway:*)","Bash(npm install -g @vesely/ai-gateway-cli)","Bash(npm list -g @vesely/ai-gateway-cli)","Bash(which ai-gateway)","Read"] |
| when_to_use | Use when the user (or your own task) needs to generate text, images, or video via an AI model and prefers a quick CLI call over writing SDK code. Trigger phrases: "generate an image of...", "make an image with AI", "make a video of...", "generate a clip of...", "ask an LLM to...", "use ai-gateway to...", "draft text with AI", "summarize via CLI", "use a Vercel AI Gateway model". Examples: "Generate a hero image of a snow leopard and save it as hero.png", "Use Nano Banana to make a logo", "Make a 5-second video of waves at sunset", "Pipe this README into an LLM and get a summary". Skip when the user wants to integrate AI into source code (use the AI SDK directly), or when they need streaming UI / tool-use / multi-turn chat. |
| argument-hint | <text|image|video> <prompt> [-m model] [-o file] [-n count] [--duration s] [--aspect r] [--resolution r] |
A thin wrapper around the ai-gateway CLI (https://vercel.com/ai-gateway) for one-shot text, image, and video generation. Use it whenever a single CLI call beats writing SDK code.
xai/grok-4.1-fast-non-reasoning (cheap + capable)google/imagen-4.0-fast-generate-001xai/grok-imagine-video-m <model-id>. Browse with ai-gateway models --type image|language|video.bfl/flux-2-pro, bfl/flux-pro-1.1, openai/gpt-image-2, google/imagen-4.0-generate-001, xai/grok-imagine-image.google/gemini-2.5-flash-image (Nano Banana), google/gemini-3.1-flash-image-preview (Nano Banana 2), google/gemini-3-pro-image.anthropic/claude-opus-4.6, openai/gpt-5.4, xai/grok-4.3.xai/grok-imagine-video (cheap), bytedance/seedance-v1.0-lite-t2v, google/veo-3.1-fast-generate-001 (premium, audio), klingai/kling-v2.6-t2v.Run which ai-gateway. If missing, install: npm install -g @vesely/ai-gateway-cli.
Success criteria: which ai-gateway returns a path.
The CLI looks for the key in this order: --key flag → AI_GATEWAY_API_KEY env → ~/.config/ai-gateway-cli/config.json. If AI_GATEWAY_API_KEY is unset AND the config file is missing/empty, ask the user for it once: tell them to either export AI_GATEWAY_API_KEY=... or run ai-gateway config set key <value>. Get a key at https://vercel.com/ai-gateway.
Success criteria: ai-gateway config shows a key (masked) OR $AI_GATEWAY_API_KEY is set.
Text (streamed to stdout):
ai-gateway "<prompt>" # default model
ai-gateway -m anthropic/claude-opus-4.6 "<prompt>"
ai-gateway --json "<prompt>" # full JSON response (.text, .usage)
cat file.md | ai-gateway "<prompt>" # piped stdin is prepended as context
Image (saves to disk, prints path):
ai-gateway image "<prompt>" # ./ai-image-<timestamp>.png
ai-gateway image -o output.png "<prompt>" # custom path
ai-gateway image -n 4 "<prompt>" # 4 images, auto-suffixed
ai-gateway image -m bfl/flux-2-pro -o cover.png "<prompt>" # specific image-only model
ai-gateway image -m google/gemini-2.5-flash-image "<prompt>" # Nano Banana (auto-routed via chat completions)
Video (saves .mp4 to disk, multi-minute job — prints a spinner with elapsed time):
ai-gateway video "<prompt>" # default model, ./ai-video-<timestamp>.mp4
ai-gateway video -o clip.mp4 --duration 5 "<prompt>" # 5-second clip
ai-gateway video -m google/veo-3.1-fast-generate-001 \
--aspect 9:16 --resolution 1080p -o vertical.mp4 "<prompt>" # vertical 1080p Veo
ai-gateway video --json --duration 5 "<prompt>" # JSON with cost + elapsed
Success criteria:
Saved: <absolute path> and the file exists on disk.Saved: <absolute path> to a non-empty .mp4 (or .webm).For text: relay the model output to the user (it's already on stdout). For image: report the absolute path(s) printed by the CLI. Do not re-encode or open the file unless asked.
Success criteria: User has the answer/file path.
~/.config/ai-gateway-cli/config.json directly.n times against /v1/chat/completions since chat has no native batch — be patient with -n 4.ai-gateway models --search <substring> to discover it instead of guessing.--json to the image/video command if the user wants a human-readable result; it suppresses the friendly "Saved: ..." lines.xai/grok-4.1-fast-reasoning, anthropic/claude-opus-4.6, or openai/gpt-5.4 via -m.Unauthorized (401) → key is wrong/expired. Reset with ai-gateway config set key <value>.Not found (404). Unknown model? → run ai-gateway models --search <hint>.Model "<id>" does not support image generation → the chosen model isn't an image-only model and lacks the image-generation tag. Pick from ai-gateway models --type image or use a multimodal LLM listed above.Video generation requires a minimum balance of $10 → top up at https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fai%3Fmodal%3Dtop-up before retrying.Compress the previous assistant response into a single TL;DR line, then propose exactly three terse next-step labels (≤8 words each, slash commands welcome) the user can take. Use whenever the user types `/tldr`, `/recap`, says "tldr", "tl;dr", "summarize and suggest next steps", "recap that", "what should I do next", "give me the gist", or otherwise asks for a quick summary of what was just said plus suggestions for what to do next. Trigger even when the user phrases it casually ("ok so what now?", "give me the short version + next steps") — this skill exists exactly for those moments where a long answer needs distilling and a clear handoff to action.
Delegate a task to Cursor's CLI agent (code review, Q&A, planning) for a second opinion from a non-Claude model
Fetch and execute a remote skill on-the-fly without installing it permanently. Use when the user wants to try a skill once, run a skill from GitHub, use a remote skill without installing, or mentions "use-skill", "run remote skill", "try this skill", "fetch skill", "one-time skill", or provides a GitHub URL/shorthand pointing to a skill they want to execute. This is the go-to skill whenever someone wants to use a skill they haven't installed locally. Also use when the user mentions skills.sh or wants to search for available skills.
Upload files to catbox.moe for free, anonymous hosting with direct links. Use when the user wants to upload an image, video, or any file to catbox, host a file online, get a direct link to a file, or mentions "catbox", "catbox.moe", "upload to catbox", "host file", or wants a permanent direct URL for a file.
Audit your Claude Code setup for token waste and context bloat. Use when the user says "audit my context", "check my settings", "why is Claude so slow", "token optimization", "context audit", or runs /context-audit. Starts by running /context to see real overhead, then audits MCP servers, CLAUDE.md rules, skills, settings, and file permissions. Returns a health score with specific fixes.
Capture the current session's repeatable process into a reusable SKILL.md skill file. Use when the user wants to create a skill, save a workflow as a skill, turn a process into a reusable skill, or mentions "skillify", "create skill", "make a skill", "save as skill", "capture workflow", "turn this into a skill", "new skill", or wants to automate a repeatable process they just performed.