Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
starchild-ai-agent avatar

Fal Image

  • 1 installs
  • 1 repo stars
  • Updated July 29, 2026
  • starchild-ai-agent/community-skills

Generate AI images via Fal.ai (Flux Pro Ultra/Pro/Dev), pick model and size presets, and download the results.

About

A skill that generates images via Fal.ai using Flux Pro, Flux Ultra, and other models, then downloads and optionally composes them for social layouts. A developer uses it to add AI image generation to a workflow with model and size guidance.

  • Flux Pro Ultra, Flux Pro, and Flux Dev model selection with size presets
  • Pillow composition script for on-brand Instagram layouts

Fal Image by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #1,200 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
npx skills add https://github.com/starchild-ai-agent/community-skills --skill fal-image

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
repo stars1
Last updatedJuly 29, 2026
Repositorystarchild-ai-agent/community-skills

What it does

Generate AI images via Fal.ai (Flux Pro Ultra/Pro/Dev), pick model and size presets, and download the results.

Files

SKILL.mdMarkdownGitHub ↗

Fal.ai Image Generation

Fal.ai is one of the most widely used API platforms for AI image generation, offering fast inference on top models including Flux Pro, Stable Diffusion, and more. To use this skill, create a free API key at [fal.ai/dashboard/keys](https://fal.ai/dashboard/keys) and add it to your .env as FAL_API_KEY.

Generate high-quality images via Fal.ai's API. The key is already in .env as FAL_API_KEY — the client needs it as FAL_KEY.

Quick Usage

import fal_client, os
os.environ['FAL_KEY'] = os.environ['FAL_API_KEY']  # required alias

result = fal_client.run(
    'fal-ai/flux-pro/v1.1-ultra',  # best model
    arguments={
        'prompt': 'your prompt here',
        'image_size': 'square_hd',   # 1:1 for Instagram feed
        'num_images': 1,
        'output_format': 'jpeg',
        'safety_tolerance': '5'      # 1=strict, 6=permissive
    }
)
url = result['images'][0]['url']  # direct CDN URL, download with requests

Models & When to Use Them

EndpointQualitySpeedUse for
fal-ai/flux-pro/v1.1-ultra⭐⭐⭐⭐⭐~8sHero shots, campaign images
fal-ai/flux-pro/v1.1⭐⭐⭐⭐~5sBatch content, iterations
fal-ai/flux/dev⭐⭐⭐~3sRapid prototyping
fal-ai/flux-realism⭐⭐⭐⭐~6sPhotorealistic shots

Default to flux-pro/v1.1-ultra unless speed matters more than quality.

Image Sizes

ValuePixelsUse for
square_hd1024×1024Instagram feed (1:1)
portrait_4_3768×1024Instagram portrait feed
portrait_16_9576×1024Instagram Stories / Reels cover
landscape_4_31024×768Wide format
landscape_16_91024×576YouTube thumbnail

Full Response Schema

result = {
    'images': [{'url': str, 'width': int, 'height': int, 'content_type': str}],
    'timings': {'inference': float},
    'seed': int,
    'has_nsfw_concepts': [bool],
    'prompt': str  # may be refined by model
}

Downloading the Image

import requests
response = requests.get(url)
with open('output/image.jpg', 'wb') as f:
    f.write(response.content)

Starchild Brand Prompt Formula

For on-brand Starchild content, prompts should include:

  • Base mood: deep black background, dark cinematic atmosphere
  • Color accent: amber orange glow, #F84600 orange light
  • Style: abstract, minimal, geometric, high contrast
  • NOT: product mockups, literal UI, stock-photo style, people, faces

Good prompt template:

[abstract concept], deep black background, [specific visual element], 
amber orange light refraction, cinematic, ultra detailed, 
8k, high contrast, minimal composition, no text

Composition Layer (Pillow)

After generating, apply the brand composition script: skills/fal-image/scripts/compose_instagram.py

This adds:

  • Starchild logo + wordmark
  • Orange top accent bar
  • Bottom gradient overlay for text legibility
  • Optional headline/subtext

Gotchas

  • Always set os.environ['FAL_KEY'] = os.environ['FAL_API_KEY'] — the client looks for FAL_KEY not FAL_API_KEY
  • URLs are temporary CDN links (~1 hour) — download immediately after generation
  • safety_tolerance: '5' is fine for abstract/artistic content; lower it for anything near real people
  • Generation is async-capable: use fal_client.submit() + fal_client.result() for batch jobs

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.