POST /ideogram/upscale

Method: POSTEndpoint: /ideogram/upscale

Remix provided images synchronously based on a given prompt and optional parameters Provides remixed images in real time based on the given prompt and optional parameters. For full parameters, see the official documentation: https://developer.ideogram.ai/api-reference/generate/post-generate-image

Request Parameters

Header Parameters

accept
string
Required
Example:
application/json
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters multipart/form-data

image_request
string
Required
Example:
{"resemblance":50,"magic_prompt_option":"AUTO","prompt":"A%20serene%20tropical%20beach%20","seed":12345,"detail":50}
image_file
file
Required
Example:
file://E:\Downloads\flux.png

Example Request

Shell

curl --location --request POST '/ideogram/upscale' \
--header 'accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'image_request="{\"resemblance\":50,\"magic_prompt_option\":\"AUTO\",\"prompt\":\"A%20serene%20tropical%20beach%20\",\"seed\":12345,\"detail\":50}"' \
--form 'image_file=@"E:\\Downloads\\flux.png"'

Response

🟢 200 Success

Content Type: application/json

Response Schema

created
string
Required
data
array
[object]
Required
is_image_safe
boolean
Optional
prompt
string
Optional
resolution
string
Optional
seed
integer
Optional
url
string
Optional

Example

{
    "data": [
        {
            "seed": 12345,
            "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.",
            "resolution": "1024x1024",
            "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
            "is_image_safe": true
        },
        {
            "seed": 12345,
            "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.",
            "resolution": "1024x1024",
            "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
            "is_image_safe": true
        }
    ],
    "created": "2000-01-23T04:56:07.000Z"
}