modbender 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