FRfriendli
Dedicated.Image

Image generations

Given a description, the model generates image(s).

post/dedicated/v1/images/generations

Request

Headers

X-Friendli-Teamstring nullable

ID of team to run requests as (optional parameter).

Request body

modelstring required

ID of target endpoint. If you want to send request to specific adapter, use the format "YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE". Otherwise, you can just use "YOUR_ENDPOINT_ID" alone.

promptstring required

A text description of the desired image(s).

num_inference_stepsinteger

The number of inference steps to use during image generation. Defaults to 20. Supported range: [1, 50].

guidance_scalenumber nullable

Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. This parameter may be irrelevant for certain models, such as FLUX.Schnell.

seedinteger nullable

The seed to use for image generation.

response_format'url' | 'raw' | 'png' | 'jpeg' | 'jpg' nullable

The format in which the generated image(s) will be returned. One of url(default), raw, png, jpeg, and jpg.

controlnet_weightsnumber[] nullable

A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.

Example request

{
  "model": "(endpoint-id)",
  "num_inference_steps": 10,
  "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."
}

Response

Successfully generated image(s).

Changes

No recorded changes to this operation across all 1 revision of this API.