Generate Image
POST
https://api.mpc.dev.placewise.com/v1/ml/general/generate_image
API Permit:ML:ImageGeneration:Post
API Context:Loyalty Club
Authorizations:User
Body Parameters
| Parameter | Type | Required? | Description |
|---|---|---|---|
| prompt | String | yes | Image generation prompt. |
| model_type | String | no (default "small") | Model type, one of: "small", "medium", "large". Larger models have higher quality, longer generation time, and higher cost. |
| aspect_ratio | String | no (default "1:1") | Image aspect ratio, one of: "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "16:9", "9:16". |
| image_size | String | no (default "thumbnail") | Image size, one of: "thumbnail" (256 px), "small" (512 px), "medium" (1024 px), "large" (1440 px). |
| creativity | Integer | no (default 2) | Variability and creativity of image generation. Only used in "medium" and "large" models. |
| photorealistic | Boolean | no (default false) | If true, generate photorealistic images. Only used in "large" model. |
| random_seed | Integer | no (default null) | If set, it results in deterministic generation. |
| Warning: for model size "small", image size must be "thumbnail" or "medium"' |
Example
When successful, returns:
{
'image_generation_task': {
'id': 1
}
}Request
Header Params
Body Params multipart/form-data
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mpc.dev.placewise.com/v1/ml/general/generate_image' \
--header 'X-User-Agent: ApiDog' \
--header 'X-Product-Name: default' \
--header 'X-Loyalty-Club-Slug: infinity-mall' \
--header 'Authorization: Bearer ' \
--form 'prompt="Minimalistic cheesecake cartoon image"' \
--form 'model_type="small"' \
--form 'aspect_ratio="1:1"' \
--form 'image_size="thumbnail"' \
--form 'creativity="2"' \
--form 'photorealistic="false"' \
--form 'random_seed="1"'Response Response Example
{
"image_generation_task": {
"id": 0
}
}