Create / edit images

POST/v1/images/generations

Generate or edit images synchronously. When image is provided, edit the reference images using the prompt.

Authorization

bearerAuth

AuthorizationBearer <token>

Use a platform API key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Platform model ID.

prompt*string

Describe the image to generate or the edits to make to the reference.

Length1 <= length

image?|array<>

Up to 3 reference images. Each must be at most 10 MB, with a long-to-short side ratio at most 10:1 and each dimension from 1 to 8000 pixels. Omit for text-to-image generation. null or an empty array returns an error.

n?integer

Number of output images.

Range1 <= value <= 6

Default1

size?string

Output size as WIDTHxHEIGHT or auto. If omitted, the model chooses. Pixel area must be from 512×512 to 2048×2048, with an aspect ratio from 1:8 to 8:1.

negative_prompt?string

Describe content to exclude.

seed?integer

Random seed.

Range0 <= value <= 2147483647

prompt_extend?boolean

Whether to enhance the prompt.

Defaulttrue

prompt_extend_mode?string

Prompt enhancement mode. agent is for text-to-image generation only and returns 400 for editing.

Default"direct"

Value in

"direct"
"agent"

enable_thinking?boolean

Whether to enable thinking. Applies only when prompt_extend is true.

Defaulttrue

watermark?boolean

Whether to add a watermark.

Defaultfalse

response_format?string

Always returns image URLs. b64_json is ignored.

Response Body

`application/json`

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Create a photo of a white mug on a wooden desk, with soft window light from the left."
  }'

{
  "created": 1793980667,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

Replace the editing example URL with the image URL generated in the previous step. For Base64, replace BASE64_BYTES with actual image data and retain the Data URL prefix matching its format.

Alibaba Cloud Qwen image generation and editing APIFields and response format of the OpenAI-compatible API.

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`