Request Schemas
Complete schemas for all API requests.
Image Generation Request
interface ImageRequest { prompt: string; negative_prompt?: string; steps?: number; guidance?: number; seed?: number; sampler?: 'euler' | 'euler_a' | 'dpmpp_2m' | 'heun'; scheduler?: 'simple' | 'normal' | 'sgm'; loras?: LoRAConfig[]; upscale?: 1.5 | 2 | 4; detail_enhance?: boolean;}
interface LoRAConfig { url: string; weight: number;}Video Generation Request
interface VideoRequest { prompt: string; image: string; duration?: number; cfg?: number; steps?: number; seed?: number;}Image-to-Image Request
interface I2IRequest { prompt: string; image: string; strength?: number; steps?: number; guidance?: number; seed?: number;}Async Queue Request
interface QueueRequest { modality: 'image' | 'video'; family: 'flux' | 'zimage' | 'wan'; model: string; task: 't2i' | 'i2i' | 't2v' | 'i2v' | 'edit'; format: string; prompt: string; priority?: 'low' | 'normal' | 'high'; webhook?: string; idempotency_key?: string; // ... other generation params}Validation Rules
Prompt
- Min length: 3 characters
- Max length: 5000 characters
- Required: Yes (except i2i with strength > 0.8)
Steps
- FLUX Dev/Dev2: 15-50
- FLUX Schnell: 4 (fixed)
- Z-Image: 5-12
Guidance
- FLUX: 1.0-5.0
- WAN: 6.0-8.0
- Z-Image: Ignored (fixed 1.0)
Seed
- Range: 0 - 4294967295
- Default: Random