Agent skill

fal

Fal.ai API for AI image and video generation. Use when user mentions "Fal.ai", "AI image generation", "video generation", or "fal" models.

View SKILL.md on GitHub Repository
Stars 50
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/vm0-ai/vm0-skills/tree/main/fal

SKILL.md

fal.ai Image Generator

Use the fal.ai API to generate images from text prompts.

Official docs: https://fal.ai/docs

When to Use

Use this skill when you need to:

  • Generate images from text descriptions
  • Create illustrations or visual content
  • Generate blog headers, thumbnails, or social media images

Prerequisites

  1. Sign up at fal.ai
  2. Get your API key from the dashboard
bash
export FAL_TOKEN="your-api-key"

How to Use

1. Generate Image (nano-banana-pro - fast)

Write to /tmp/fal_request.json:

json
{
  "prompt": "A futuristic city at sunset, cyberpunk style"
}

Then run:

bash
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

2. Generate Image (flux/schnell - fast)

Write to /tmp/fal_request.json:

json
{
  "prompt": "A cute cat eating a cookie"
}

Then run:

bash
curl -s -X POST "https://fal.run/fal-ai/flux/schnell" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

3. Generate Image (recraft-v3 - high quality)

Write to /tmp/fal_request.json:

json
{
  "prompt": "Abstract art, vibrant colors"
}

Then run:

bash
curl -s -X POST "https://fal.run/fal-ai/recraft-v3" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

4. Generate with Custom Size

Write to /tmp/fal_request.json:

json
{
  "prompt": "Mountain landscape",
  "image_size": "landscape_16_9"
}

Then run:

bash
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

5. Download Generated Image

Write to /tmp/fal_request.json:

json
{
  "prompt": "A minimalist workspace"
}

Then run:

bash
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url' | xargs curl -sL -o /tmp/image.png

6. Pipe Prompt from Echo (JSON escaped)

bash
echo "A dragon breathing fire, epic fantasy art" | jq -Rs '{prompt: .}' > /tmp/fal_request.json
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

7. Pipe Prompt from File (JSON escaped)

bash
cat /tmp/prompt.txt | jq -Rs '{prompt: .}' > /tmp/fal_request.json
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

8. Pipe with Additional Parameters

bash
echo "Neon city at night" | jq -Rs '{prompt: ., image_size: "landscape_16_9"}' > /tmp/fal_request.json
curl -s -X POST "https://fal.run/fal-ai/nano-banana-pro" --header "Authorization: Key $(printenv FAL_TOKEN)" --header "Content-Type: application/json" -d @/tmp/fal_request.json | jq -r '.images[0].url'

Available Models

Model Description
nano-banana-pro Fast, good quality (recommended)
flux/schnell Fast generation
flux-pro High quality
recraft-v3 High quality vector/illustration

See more at: https://fal.ai/models

Image Sizes

Size Aspect Ratio
square 1:1
square_hd 1:1 (high res)
portrait_4_3 4:3
portrait_16_9 16:9
landscape_4_3 3:4
landscape_16_9 9:16

Prompt Guidelines

For best results:

  1. Be specific - Describe the subject clearly
  2. Add style hints - "modern", "minimalist", "photorealistic", "digital art", "cinematic"
  3. Specify colors/mood - "blue and purple gradient", "warm tones", "dark and moody"
  4. Keep it concise - Clear and focused descriptions work better

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vm0-ai/vm0-skills

brave-search

Brave Search API for web search. Use when user says "search web", "Brave search", or asks to "find on web" without specifying Google.

50 8
Explore
vm0-ai/vm0-skills

supadata

Supadata API for YouTube/web data. Use when user mentions "Supadata", "YouTube data", "channel stats", or web scraping data.

50 8
Explore
vm0-ai/vm0-skills

roadmap-planning

Build and prioritize product roadmaps using scoring models like RICE, ICE, and value-effort matrices. Activate when creating a product roadmap, prioritizing features, sequencing initiatives, mapping dependencies, balancing team capacity, choosing between Now/Next/Later or quarterly planning, or communicating roadmap tradeoffs to executives and stakeholders.

50 8
Explore
vm0-ai/vm0-skills

qdrant

Qdrant API for vector search. Use when user mentions "Qdrant", "vector database", "semantic search", or embeddings storage.

50 8
Explore
vm0-ai/vm0-skills

calendly

Calendly scheduling API. Use when user mentions "Calendly", "calendly.com", "schedule a meeting", "booking link", "event types", or asks about interview scheduling.

50 8
Explore
vm0-ai/vm0-skills

stripe

Stripe API for payments. Use when user mentions "Stripe", "payment", "subscription", "billing", "invoice", or asks about payment processing.

50 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results