Learn how to use our powerful image generation tools to create, modify, and upscale images.
View API ReferenceArli AI Image Generation runs on SDNext and vLLM-Omni. SDNext models expose a broad subset of the Stable Diffusion API (samplers, schedulers, detailer, IP-Adapter, ControlNet, and upscaling). vLLM-Omni models expose a fixed sampler/scheduler pipeline with OpenAI Images parameters such as size, steps, guidance, flow shift, and model-specific extra parameters.
https://github.com/vladmandic/sdnexthttps://github.com/vllm-project/vllm-omniAll Image Generation API endpoints require authentication using a Bearer token or Basic Authentication via the Authorization header. Replace {ARLIAI_API_KEY} in the examples with your actual API key. For Basic Auth, use your API key as the password, Base64 encoded (e.g., Authorization: Basic Base64Encode(ARLIAI_API_KEY)).
API requests are routed to appropriate backend servers based on model requirements and availability. Ensure your account has access to the specific image generation models or upscaler models you intend to use via GET /v1/img-models, GET /sdapi/v1/sd-models, or GET /v1/upscalers.
Image generation and upscaling requests are subject to rate limits and concurrency limits based on your account plan. Exceeding limits may result in temporary account restrictions. Check your account dashboard for details on your limits.
API Key parameter overrides (set in your account settings) will merge with and take precedence over parameters sent in the request body for compatible parameters.
Successful SDNext-style POST requests (txt2img, img2img, control, extra-single-image) return a JSON object containing base64 encoded image(s) in the images field (or image for upscale) and an info field with generation parameters. OpenAI-style requests return images in data[].b64_json. Successful GET requests return JSON data as described in their respective sections.
Some image models on Arli AI run on vLLM-Omni instead of SD.Next. The SDNext-compatible /v1/txt2img, /v1/img2img, /sdapi/v1/txt2img, and /sdapi/v1/img2img endpoints still work for both engines, and vLLM-Omni models also expose the OpenAI Images API.
width/height become size, steps becomes num_inference_steps, cfg_scale becomes guidance_scale, batch_size becomes n, and denoising_strength becomes strength. flow_shift and extra_params are forwarded for vLLM-Omni text-to-image.sampler_name, most scheduler fields, detailer, IP-Adapter, and ControlNet fields are not applied; schedulers_shift is used as a fallback for flow_shift on text-to-image. ControlNet generation and preprocessing are SD.Next-only.maxSteps (default 40), maxBatchSize, maxCfgScale (default 30), and sizeMultiple. MOSS-Image requires dimensions in multiples of 16; MiniMax-H3-Image uses a 32-pixel grid. Read the exact values from GET /v1/img-models.supportsImg2Img, and sending a mask requires supportsInpaint. OpenAI edits require supportsImg2Img. MOSS-Image-SFT is text-to-image only.flow_shift and extra_params are text-to-image only and are not applied to edits.POST /v1/images/generations requires model and a healthy vLLM-Omni server. It accepts prompt, negative_prompt, size (or width/height), n, seed, num_inference_steps, guidance_scale, true_cfg_scale, flow_shift, extra_params, output_format, output_compression, generator_device, layers, resolution, strength, sigmas, num_frames, bot_task, system_prompt, use_system_prompt, and return_stage_metrics. response_format is accepted but images are always returned in data[].b64_json. n must be 1-10 and cannot exceed the model maxBatchSize.POST /v1/images/edits requires model and supportsImg2Img. Send multipart image/image[] plus optional mask_image or reference_image, or JSON base64 image, images, init_images, mask, or mask_image. Edits accept prompt, negative_prompt, size (defaults to the input image or auto), n, num_inference_steps, guidance_scale, true_cfg_scale, strength, seed, generator_device, layers, resolution, output_format, output_compression, bot_task, system_prompt, and return_stage_metrics. flow_shift and extra_params are not applied to edits.GET /v1/images/models lists only models with a healthy vLLM-Omni server in OpenAI model-list format. GET /v1/img-models returns the full catalog with engine, per-model limits, capability flags, and curated defaults. vLLM-Omni models can also be used through /sdapi/v1/txt2img, /v1/txt2img, /sdapi/v1/img2img, and /v1/img2img when their capability flags allow it.The Text-to-Image page allows you to create images from a text description (a "prompt"). You describe what you want to see, and the AI will generate it for you.



This tool transforms an existing image based on your text prompt. Img2img is available only for models whose supportsImg2Img capability is not false; inpainting also requires supportsInpaint. MOSS-Image-SFT is text-to-image only.



Increase the resolution of your images while adding detail. Upscaling is served by SD.Next upscaler models; vLLM-Omni models do not provide an upscaling path.
