Skip to main content
POST
/
images
/
generations
curl --request POST \
  --url https://api.siliconflow.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR-API-KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "Kwai-Kolors/Kolors",
  "prompt": "an island near sea, with seagulls, moon shining over the sea, light house, boats int he background, fish flying over the sea",
  "image_size": "1024x1024",
  "batch_size": 1,
  "num_inference_steps": 20,
  "guidance_scale": 7.5
}'
{
  "images": [
    {
      "url": "<string>"
    }
  ],
  "timings": {
    "inference": 123
  },
  "seed": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.siliconflow.cn/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use the following format for authentication: Bearer

Body

application/json
​
model
string
required

Corresponding Model Name. To better enhance service quality, we will make periodic changes to the models provided by this service, including but not limited to model on/offlining and adjustments to model service capabilities. We will notify you of such changes through appropriate means such as announcements or message pushes where feasible. For a complete list of available models, please check the Models.

Example:

"Qwen/Qwen-Image-Edit-2509"

​
prompt
string
required
Example:

"an island near sea, with seagulls, moon shining over the sea, light house, boats int he background, fish flying over the sea"

​
negative_prompt
string

negative prompt

​
image_size
string

Image resolution in "widthxheight" format (Required). To ensure optimal quality, using the recommended values for your model is strongly advised. Qwen/Qwen-Image-Edit-2509 and Qwen/Qwen-Image-Edit not support this field. Recommended Values:

  • For Kolor model:
    • "1024x1024" (1:1)
    • "960x1280" (3:4)
    • "768x1024" (3:4)
    • "720x1440" (1:2)
    • "720x1280" (9:16)
  • For Qwen-Image model:
    • "1328x1328" (1:1)
    • "1664x928" (16:9)
    • "928x1664" (9:16)
    • "1472x1140" (4:3)
    • "1140x1472" (3:4)
    • "1584x1056" (3:2)
    • "1056x1584" (2:3)
​
batch_size
integer
default:1

number of output images. Only applicable to Kwai-Kolors/Kolors.

Required range: 1 <= x <= 4
​
seed
integer
Required range: 0 <= x <= 9999999999
​
num_inference_steps
integer
default:20

number of inference steps

Required range: 1 <= x <= 100
​
guidance_scale
number
default:7.5

This value is used to control the degree of match between the generated image and the given prompt. The higher the value, the more the generated image will tend to strictly match the text prompt. The lower the value, the more creative and diverse the generated image will be, potentially containing more unexpected elements. Only applicable to Kwai-Kolors/Kolors.

Required range: 0 <= x <= 20
​
image
enum<string>

The image used for uploading an image can be in base64 format or a URL.

Available options:
data:image/png;base64, XXX,
img_url
Example:

"https://inews.gtimg.com/om_bt/Os3eJ8u3SgB3Kd-zrRRhgfR5hUvdwcVPKUTNO6O7sZfUwAA/641"

​
image2
enum<string>

The image used for uploading an image can be in base64 format or a URL. This field is only applicable to Qwen/Qwen-Image-Edit-2509.

Available options:
data:image/png;base64, XXX,
img_url
Example:

"https://inews.gtimg.com/om_bt/Os3eJ8u3SgB3Kd-zrRRhgfR5hUvdwcVPKUTNO6O7sZfUwAA/641"

​
image3
enum<string>

The image used for uploading an image can be in base64 format or a URL. This field is only applicable to Qwen/Qwen-Image-Edit-2509.

Available options:
data:image/png;base64, XXX,
img_url
Example:

"https://inews.gtimg.com/om_bt/Os3eJ8u3SgB3Kd-zrRRhgfR5hUvdwcVPKUTNO6O7sZfUwAA/641"

Response

The response from the model. The response header contains the x-siliconcloud-trace-id field, which serves as a unique identifier for tracing requests, facilitating log queries and issue troubleshooting.

​
images
object[]
​
timings
object
​
seed
integer