Upscale provided images synchronously with an optional prompt.

POST

A request to upscale a provided image with Ideogram.

Supported image formats include JPEG, PNG, and WEBP

Request

This endpoint expects a multipart form containing a file.

image_requestobjectRequired

A request to upscale a provided image with the help of an optional prompt.

image_filefileRequired

Response

This endpoint returns an object.

createddatetime

The time the request was created.

datalist of objects

A list of ImageObjects that contain the generated image(s).

Errors

POST

1 curl -X POST https://api.ideogram.ai/upscale \
2      -H "Api-Key: <apiKey>" \
3      -H "Content-Type: multipart/form-data" \
4      -F image_request='{}' \
5      -F image_file=@<file1>

1 {
2   "created": "2000-01-23T04:56:07Z",
3   "data": [
4     {
5       "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
6       "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
7       "resolution": "1024x1024",
8       "is_image_safe": true,
9       "seed": 12345
10     },
11     {
12       "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
13       "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
14       "resolution": "1024x1024",
15       "is_image_safe": true,
16       "seed": 12345
17     }
18   ]
19 }

Built with

1	curl -X POST https://api.ideogram.ai/upscale \
2	-H "Api-Key: <apiKey>" \
3	-H "Content-Type: multipart/form-data" \
4	-F image_request='{}' \
5	-F image_file=@<file1>

1	{
2	"created": "2000-01-23T04:56:07Z",
3	"data": [
4	{
5	"url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
6	"prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
7	"resolution": "1024x1024",
8	"is_image_safe": true,
9	"seed": 12345
10	},
11	{
12	"url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
13	"prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
14	"resolution": "1024x1024",
15	"is_image_safe": true,
16	"seed": 12345
17	}
18	]
19	}