Skip to content
LLM-friendly formats:

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