image-expand

Ideogram - Expand image

This endpoint allows you to expand an image using the Ideogram AI model. The image will be expanded based on the provided pixel values for each side. If no prompt is provided, the model will auto-generate one based on the image content.

Output size

left, right, top and bottom define the aspect ratio of the result, not its pixel dimensions. The canvas is built as input_width + left + right by input_height + top + bottom, and the model then renders it at approximately 1 megapixel, picking the closest match from its own fixed list of supported resolutions (all multiples of 32). The pixel values you send are therefore not preserved:

Requested canvasActual output
896x1172832x1088
1396x6721472x704
896x8961024x1024
4992x47681024x960

As the last row shows, a very large expansion does not produce a larger image: it only changes the shape. If you need specific output dimensions, resize the result yourself after generation.

left, right, top and bottom are all required. At least one of them must be greater than 0, otherwise the request returns a 400; the other three may be 0.

post/v1/ai/image-expand/ideogram

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/image-expand/ideogram
  • Auth: API key in header x-magnific-api-key

Request body

webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

imagestring byte required

Base64 image to expand

promptstring

Optional text prompt describing the desired expanded content. If not provided, the AI model will auto-generate a prompt based on the image.

leftinteger required

Number of pixels to expand on the left side

rightinteger required

Number of pixels to expand on the right side

topinteger required

Number of pixels to expand on the top side

bottominteger required

Number of pixels to expand on the bottom side

seedinteger

Optional seed for reproducibility

Example request

{
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.