Build with Qwen2
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": "qwen2-text-to-image",
"input": {
"image_size": "16:9",
"prompt": "<prompt>"
}
}'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: 5000 characters.
image_sizestringThe size of the generated image. Default value: 16:9
Options: 1:1, 3:4, 4:3, 9:16, 16:9
nsfw_checkerbooleanDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.
output_formatstringOutput format: png or jpeg. Set this field explicitly.
Options: jpeg, png
Full input schema
{
"type": "object",
"required": [
"prompt"
],
"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": 5000,
"description": "The prompt to generate the image with. Max length: 5000 characters."
},
"image_size": {
"enum": [
"1:1",
"3:4",
"4:3",
"9:16",
"16:9"
],
"type": "string",
"title": "Image size",
"default": "16:9",
"description": "The size of the generated image. Default value: 16:9"
},
"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",
"description": "Output format: png or jpeg. Set this field explicitly."
}
}
}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.
