Introduction
# 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
```bash 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:
```bash 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
```bash python3 scripts/image.py upscale ./small.png --factor 4 -o ./large.png ```
### List Models
```bash python3 scripts/image.py models ```
## Video Generation
### Text-to-Video
```bash 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:
```bash # 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
```bash 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