Runware

Image and video generation via Runware's unified API. Access FLUX, Stable Diffusion XL, Kling AI, and more.

Setup

Set RUNWARE_API_KEY environment variable, or pass --api-key to scripts.

Get API key: https://runware.ai

Image Generation

Text-to-Image

python3 scripts/image.py gen "a cyberpunk city at sunset, neon lights, rain" --count 2 -o ./images

Options:

• --model: Model ID (default: runware:101@1 / FLUX.1 Dev)
• --width/--height: Dimensions (default: 1024x1024)
• --steps: Inference steps (default: 25)
• --cfg: CFG scale (default: 7.5)
• --count/-n: Number of images
• --negative: Negative prompt
• --seed: Reproducible seed
• --lora: LoRA model ID
• --format: png/jpg/webp

Image-to-Image

Transform an existing image:

python3 scripts/image.py img2img ./photo.jpg "watercolor painting style" --strength 0.7

• --strength: How much to transform (0=keep original, 1=ignore original)

Upscale

python3 scripts/image.py upscale ./small.png --factor 4 -o ./large.png

List Models

python3 scripts/image.py models

Video Generation

Text-to-Video

python3 scripts/video.py gen "a cat playing with yarn, cute, high quality" --duration 5 -o ./cat.mp4

Options:

• --model: Model ID (default: klingai:5@3 / Kling AI 1.6 Pro)
• --duration: Length in seconds
• --width/--height: Resolution (default: 1920x1080)
• --negative: Negative prompt
• --format: mp4/webm/mov
• --max-wait: Polling timeout (default: 600s)

Image-to-Video

Animate an image or interpolate between frames:

# Single image (becomes first frame)
python3 scripts/video.py img2vid ./start.png --prompt "zoom out slowly" -o ./animated.mp4

# Two images (first and last frame)
python3 scripts/video.py img2vid ./start.png ./end.png --duration 5

List Video Models

python3 scripts/video.py models

Popular Models

Image

| Model | ID | |-------|-----| | FLUX.1 Dev | runware:101@1 | | FLUX.1 Schnell (fast) | runware:100@1 | | FLUX.1 Kontext | runware:106@1 | | Stable Diffusion XL | civitai:101055@128080 | | RealVisXL | civitai:139562@297320 |

Video

| Model | ID | |-------|-----| | Kling AI 1.6 Pro | klingai:5@3 | | Kling AI 1.5 Pro | klingai:3@2 | | Runway Gen-3 | runwayml:1@1 |

Browse all: https://runware.ai/models

Notes

• Video generation is async; scripts poll until complete
• Costs vary by model — check https://runware.ai/pricing
• FLUX models are excellent for quality; Schnell is faster
• For best video results, use descriptive prompts with motion words