Try Image Generation

Test the image generation API interactively. Select a model, configure parameters, and generate images.

Generate images

post

Generate images from text prompts. See the model-specific guides below for detailed usage.

Authorizations

AuthorizationstringRequired

API key passed as a Bearer token. Generate your key at platform.qolaba.ai. Example: Authorization: Bearer sk-xxxxxxxxxxxx

Body

modelstring · enumRequired

Image model ID

Example: vertex/nano-banana-flashPossible values:

promptstring · max: 4000Required

Text description of the image to generate

Example: A serene mountain landscape at sunset with golden light

modestring · enumOptional

sync returns images directly; async returns a task_id to poll

Default: syncPossible values:

negative_promptstring · max: 2000Optional

What to avoid in the generated image

aspect_ratiostring · enumOptional

Output aspect ratio

Default: 1:1Possible values:

qualitystring · enumOptional

Output resolution

Default: 2KPossible values:

num_imagesinteger · min: 1 · max: 10Optional

Number of images to generate

Default: 1

temperaturenumber · max: 2Optional

Creativity control. Lower = faithful, higher = creative

Default: 1

seedintegerOptional

Random seed for reproducibility. Same seed + prompt = same image

use_search_groundingbooleanOptional

Enable real-time Google Search for factual/visual accuracy (Nano Banana Flash only)

Default: false

output_formatstring · enumOptional

Output image format

Possible values:

image_urlsstring · uri[]Optional

Input image URLs for image-to-image generation

strengthnumber · max: 1Optional

Strength of image transformation for image-to-image (0-1)

num_inference_stepsintegerOptional

Number of diffusion steps (model-dependent)

guidance_scalenumberOptional

Classifier-free guidance scale

backgroundstring · enumOptional

Background mode

Possible values:

colorsstring[] · max: 5Optional

Color palette constraints

stylestringOptional

Style preset

image_sizestring · enumOptional

Output resolution (Imagen models)

Possible values:

enhance_promptbooleanOptional

Let the model enhance your prompt (Imagen models)

add_watermarkbooleanOptional

Add invisible watermark (Imagen models)

person_generationstring · enumOptional

Person generation policy (Imagen models)

Possible values:

safety_filter_levelstring · enumOptional

Safety filter level (Imagen models)

Possible values:

output_compression_qualityinteger · max: 100Optional

JPEG compression quality (Imagen models)

call_webhookbooleanOptional

Send a POST callback when generation completes

Default: false

webhook_urlstring · uriOptional

Webhook destination URL. Required when call_webhook is true

webhook_secretstringOptional

Secret sent as x-webhook-secret header in the webhook callback

Responses

200

Synchronous generation result

application/json

task_idstringOptional

statusstring · enumOptionalPossible values:

202

Async task created — poll GET /tasks/{task_id}

application/json

400

Invalid request parameters

application/json

401

Missing or invalid API key

application/json

403

Organization has insufficient credits

application/json

502

Upstream provider error

application/json

post/images/generate

POST /api/v1/images/generate HTTP/1.1
Host: api.platform.qolaba.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 232

{
  "model": "vertex/nano-banana-flash",
  "prompt": "Place this product on a clean white marble countertop with soft studio lighting",
  "image_urls": [
    "https://cdn.qolaba.ai/1783597584051_rynfv3hev4.jpeg"
  ],
  "quality": "2K",
  "aspect_ratio": "1:1"
}

{
  "task_id": "task_abc123",
  "status": "completed",
  "output": {
    "images": [
      {
        "url": "https://cdn.qolaba.ai/generated/img_001.png"
      }
    ]
  },
  "usage": {
    "cost_usd": 0.04,
    "images_generated": 1
  }
}

List image models

get

Retrieve all available image generation models with capabilities and supported formats.

Authorizations

AuthorizationstringRequired

API key passed as a Bearer token. Generate your key at platform.qolaba.ai. Example: Authorization: Bearer sk-xxxxxxxxxxxx

Responses

200

List of image models

application/json

idstringOptional

modelstringOptional

providerstringOptional

capabilitiesstring[]Optional

supported_formatsstring[]Optional

401

Missing or invalid API key

application/json

403

Organization has insufficient credits

application/json

get/images/models

GET /api/v1/images/models HTTP/1.1
Host: api.platform.qolaba.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "model": "text",
    "provider": "text",
    "capabilities": [
      "text"
    ],
    "supported_formats": [
      "text"
    ]
  }
]

Get task status

get

Poll the status of an async task (e.g. image generation with mode: "async"). Keep polling until status is completed or failed.

Authorizations

AuthorizationstringRequired

API key passed as a Bearer token. Generate your key at platform.qolaba.ai. Example: Authorization: Bearer sk-xxxxxxxxxxxx

Path parameters

task_idstringRequired

The task ID returned by an async operation

Responses

200

Task status and results

application/json

task_idstringOptional

statusstring · enumOptionalPossible values:

401

Missing or invalid API key

application/json

403

Organization has insufficient credits

application/json

get/tasks/{task_id}

GET /api/v1/tasks/{task_id} HTTP/1.1
Host: api.platform.qolaba.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "task_id": "text",
  "status": "pending",
  "output": {
    "images": [
      {
        "url": "https://example.com"
      }
    ],
    "usage": {
      "cost_usd": 1,
      "images_generated": 1
    }
  }
}