Images

Create Image

Changed on Apr 13, 2026

Generate an image with minimal or advanced parameters.

post/images/generations

Request

Base URL
https://platform.qubrid.com/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/qubrid/apis/qubrid-image-api/docs/images/generations/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

modelstring required

The image generation model to use.

promptstring required

The text prompt describing the image to generate.

enhance_promptboolean

Whether to automatically enhance the prompt before generation.

go_fastboolean

Whether to prioritize faster generation.

guidancenumber

Guidance scale controlling prompt adherence.

negative_promptstring

Elements you want to avoid in the generated image.

num_inference_stepsinteger

Number of denoising steps used during generation.

seedinteger nullable

Optional random seed for reproducible results.

disable_safety_checkerboolean

Disable the safety checker for generation.

imagestring nullable

Optional input image for image-to-image generation or editing.

strengthnumber

Strength of transformation when using an input image.

lora_weightsstring nullable

Optional LoRA weights identifier.

lora_scalenumber

Scale factor for the primary LoRA weights.

extra_lora_weightsstring[]

Additional LoRA weights to apply.

extra_lora_scalenumber[]

Scale values for additional LoRA weights.

aspect_ratiostring

Aspect ratio for the generated image.

image_sizestring

Controls image resolution or optimization mode.

output_formatstring

Desired output image format.

output_qualityinteger

Compression quality for the output image.

Example request

{
  "model": "qwen-image",
  "prompt": "A futuristic city skyline at sunset",
  "aspect_ratio": "16:9",
  "image_size": "optimize_for_quality",
  "output_format": "webp"
}

Response

Image generated successfully

createdinteger

Unix timestamp when the image was generated.

Example response

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://cdn.qubrid.com/generated/image.webp",
      "b64_json": "/9j/4AAQSkZJRgAB..."
    }
  ]
}

Changes

Apr 13, 20261b2db4255b7c Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history