Build with Qwen Image Edit
Make your first request
Use your Sorceress API key on your server. The playground uses your signed-in account; your application uses the same model with an API key.
curl -X POST 'https://sorceress.games/api/v1/jobs' \
-H 'Authorization: Bearer $SORCERESS_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "qwen-image-edit",
"input": {
"image_size": "landscape_4_3",
"acceleration": "none",
"output_format": "png",
"guidance_scale": 4,
"num_inference_steps": 25,
"prompt": "<prompt>",
"image_url": "<image_url>"
}
}'Inputs & settings
seedintegerThe same seed and the same prompt given to the same version of the model will output the same image every time.
promptstringRequiredThe prompt to generate the image with (Max length: 2000 characters)
image_urlstringRequiredThe URL of the image to edit. (Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
image_sizestringThe size of the generated image. Default value: landscape_4_3
Options: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_imagesstringnum_images
Options: 1, 2, 3, 4
accelerationstringAcceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. Default value: "none"
Options: none, regular, high
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
output_formatstringThe format of the generated image. Default value: "png"
Options: jpeg, png
guidance_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Default value: 4 (Min: 0, Max: 20, Step: 0.1) (step: 0.1)
negative_promptstringThe negative prompt for the generation Default value: " " (Max length: 500 characters)
num_inference_stepsnumberThe number of inference steps to perform. Default value: 30 (Min: 2, Max: 49, Step: 1) (step: 1)
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Default value: true (Boolean value (true/false))
Full input schema
{
"type": "object",
"required": [
"prompt",
"image_url"
],
"properties": {
"seed": {
"type": "integer",
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time."
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 2000,
"description": "The prompt to generate the image with (Max length: 2000 characters)"
},
"image_url": {
"type": "string",
"title": "Image URL",
"format": "uri",
"x-media": "image",
"description": "The URL of the image to edit. (Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)"
},
"image_size": {
"enum": [
"square",
"square_hd",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"type": "string",
"title": "Image size",
"default": "landscape_4_3",
"description": "The size of the generated image. Default value: landscape_4_3"
},
"num_images": {
"enum": [
"1",
"2",
"3",
"4"
],
"type": "string",
"title": "Num images",
"description": "num_images"
},
"acceleration": {
"enum": [
"none",
"regular",
"high"
],
"type": "string",
"title": "Acceleration",
"default": "none",
"description": "Acceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. Default value: \"none\""
},
"nsfw_checker": {
"type": "boolean",
"title": "NSFW checker",
"description": "Defaults to false. When false, no additional content filtering is applied and results are returned directly by the model."
},
"output_format": {
"enum": [
"jpeg",
"png"
],
"type": "string",
"title": "Output format",
"default": "png",
"description": "The format of the generated image. Default value: \"png\""
},
"guidance_scale": {
"type": "number",
"title": "Guidance scale",
"default": 4,
"maximum": 20,
"minimum": 0,
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Default value: 4 (Min: 0, Max: 20, Step: 0.1) (step: 0.1)"
},
"negative_prompt": {
"type": "string",
"title": "Negative prompt",
"maxLength": 500,
"description": "The negative prompt for the generation Default value: \" \" (Max length: 500 characters)"
},
"num_inference_steps": {
"type": "number",
"title": "Num inference steps",
"default": 25,
"maximum": 49,
"minimum": 2,
"description": "The number of inference steps to perform. Default value: 30 (Min: 2, Max: 49, Step: 1) (step: 1)"
},
"enable_safety_checker": {
"type": "boolean",
"title": "Enable safety checker",
"description": "If set to true, the safety checker will be enabled. Default value: true (Boolean value (true/false))"
}
}
}Results, saved runs & billing
Media requests return a job ID. Poll GET /api/v1/jobs/:id until it succeeds or fails; keep the same ID while it is processing. Long chat requests can also return a saved job to poll. Completed outputs are stored in your account, and successful work is billed using your model's current rates.
A multi-step workflow may include separately billed successful actions. If a connection drops, check your saved run before submitting it again.






