Skip to main content
POST
/
dedicated
/
v1
/
images
/
generations
Image generations
curl --request POST \
  --url https://api.friendli.ai/dedicated/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "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."
}'
{
  "data": [
    {
      "url": "(url-to-generated-image)",
      "seed": 123,
      "response_format": "url"
    }
  ]
}
Given a description, the model generates image(s). To request successfully, it is mandatory to enter a Friendli Token (e.g. flp_XXX) value in the Bearer Token field. Refer to the authentication section on our introduction page to learn how to acquire this variable and visit here to generate your token.

Authorizations

​
Authorization
string
header
required

When using Friendli Suite API for inference requests, you need to provide a Friendli Token for authentication and authorization purposes.

For more detailed information, please refer here.

Headers

​
X-Friendli-Team
string | null

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

Body

application/json
​
model
string
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.

Examples:

"(endpoint-id)"

​
prompt
string
required

A text description of the desired image(s).

​
num_inference_steps
integer
required

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

​
guidance_scale
number | null

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.

​
seed
integer | null

The seed to use for image generation.

​
response_format
enum<string> | null
default:url

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

Available options:
url,
raw,
png,
jpeg,
jpg

Response

Successfully generated image(s).

​
data
required