---
title: "POST /generation/create-image"
method: POST
path: "/generation/create-image"
tags: ["تولید محتوا"]
---

# POST /generation/create-image

`POST /generation/create-image`

ایجاد درخواست تولید تصویر

## Query parameters

- `webhookUrl` string — Your Webhook URL, if specified, the result of the generation will be POSTed to this URL.
- `demoMode` 'failure' | 'success' — This parameter is used when the api key mode is 'development', default value is 'success'. when set to 'failure', the dummy generation will be 'failed' after a few seconds, if set to 'success', the dummy generation will be 'completed' after a few seconds.

## Request body

- union
  - object
    - `prompt` string, required
    - `quality` '2K' | '4K', required
    - `model` 'gemini-3', required — اسم مدل
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `aspectRatio` 'auto' | '21:9' | '1:1' | '4:3' | '3:2' | '2:3' | '5:4' | '4:5' | '3:4' | '16:9' | '9:16', required
    - `pngMode` boolean, required
  - object
    - `prompt` string, required
    - `quality` '2K' | '4K', required
    - `model` 'nano-2', required — اسم مدل
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `aspectRatio` 'auto' | '21:9' | '1:1' | '4:3' | '3:2' | '2:3' | '5:4' | '4:5' | '3:4' | '16:9' | '9:16', required
  - object
    - `prompt` string, required
    - `model` 'gpt-image-2', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '5:4' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '4:5' | '9:16', required
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `quality` '1K' | '2K' | '4K', required
    - `version` 'low' | 'medium' | 'high', required
  - object
    - `prompt` string, required
    - `model` 'seedream5-lite', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '9:16' | 'auto', required
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
  - object
    - `model` 'crystal', required — اسم مدل
    - `scale` '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10', required
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `creative` '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10', required
  - object
    - `model` 'o3', required — اسم مدل
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `quality` '1K' | '2K' | '4K', required
    - `prompt` string, required
    - `aspectRatio` '9:16' | '2:3' | '3:4' | '1:1' | '4:3' | '3:2' | '16:9' | '21:9' | 'auto', required
    - `elements` object[]
      - `name` string, required
      - `type` 'کاراکتر/شخص' | 'حیوان' | 'اشیا' | 'لباس/پوشیدنی' | 'محیط/صحنه' | 'افکت' | 'سایر', required
      - `images` string[], required
      - `description` string, required
  - object
    - `prompt` string, required
    - `model` 'seedream-45', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '9:16' | 'auto', required
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
  - object
    - `prompt` string, required
    - `model` 'seedream-4', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '9:16' | 'auto', required
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
  - object
    - `prompt` string, required
    - `model` 'gemini-2-5', required — اسم مدل
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `aspectRatio` 'auto' | '21:9' | '1:1' | '4:3' | '3:2' | '2:3' | '5:4' | '4:5' | '3:4' | '16:9' | '9:16', required
  - object
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `prompt` string, required
    - `model` 'kontext', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '9:16' | 'auto', required
    - `version` 'pro' | 'max', required
  - object
    - `prompt` string, required
    - `model` 'flux1.1-pro-ultra', required — اسم مدل
    - `aspectRatio` '21:9' | '16:9' | '4:3' | '3:2' | '1:1' | '2:3' | '3:4' | '9:16' | 'auto', required
  - object
    - `model` 'normal-upscale', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
  - object
    - `prompt` string, required
    - `model` 'gpt-image-1.5', required — اسم مدل
    - `aspectRatio` '1:1' | '3:2' | '2:3', required
    - `images` string[] — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
    - `version` 'low' | 'medium' | 'high', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'low-res-2', required
    - `sharpen` number, required
    - `denoise` number, required
    - `fixCompression` number, required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'std-2', required
    - `sharpen` number, required
    - `denoise` number, required
    - `fixCompression` number, required
    - `subjectDetection` 'All' | 'Background' | 'Foreground', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'std-max', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'cgi', required
    - `sharpen` number, required
    - `denoise` number, required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'high-fid-2', required
    - `sharpen` number, required
    - `denoise` number, required
    - `fixCompression` number, required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'text-refine', required
    - `sharpen` number, required
    - `denoise` number, required
    - `fixCompression` number, required
    - `textRefineStrength` number, required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'recovery', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'redefine', required
    - `prompt` string
    - `sharpen` number, required
    - `denoise` number, required
    - `creativity` '1' | '2' | '3' | '4' | '5' | '6', required
    - `texture` '1' | '2' | '3' | '4' | '5', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'recovery-2', required
    - `detail` number, required
    - `subjectDetection` 'All' | 'Background' | 'Foreground', required
  - object
    - `model` 'topaz', required — اسم مدل
    - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint. - دقیقا یک تصویر در آرایه الزامی است.
    - `scale` number, required
    - `outputFormat` 'jpeg' | 'png', required
    - `faceEnhancement` object, required
      - `enabled` boolean, required
      - `creativity` number, required
      - `strength` number, required
    - `version` 'wonder', required

## Response `200`

Response for status 200

- object
  - `genId` string, required

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `403` — Response for status 403
- `500` — Response for status 500

---

[API](https://skmtc.dev/radinai/apis/api.md) · [All operations](https://skmtc.dev/radinai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/radinai/api/revisions/ab972cf11ad1/schema)