Ideogram - Expand image

curl --request POST \
  --url https://api.magnific.com/v1/ai/image-expand/ideogram \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "left": 1024,
  "right": 1024,
  "top": 1024,
  "bottom": 1024,
  "webhook_url": "https://www.example.com/webhook",
  "prompt": "<string>",
  "seed": 1073741823
}
'

import requests

url = "https://api.magnific.com/v1/ai/image-expand/ideogram"

payload = {
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "left": 1024,
    "right": 1024,
    "top": 1024,
    "bottom": 1024,
    "webhook_url": "https://www.example.com/webhook",
    "prompt": "<string>",
    "seed": 1073741823
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    left: 1024,
    right: 1024,
    top: 1024,
    bottom: 1024,
    webhook_url: 'https://www.example.com/webhook',
    prompt: '<string>',
    seed: 1073741823
  })
};

fetch('https://api.magnific.com/v1/ai/image-expand/ideogram', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/image-expand/ideogram",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'left' => 1024,
    'right' => 1024,
    'top' => 1024,
    'bottom' => 1024,
    'webhook_url' => 'https://www.example.com/webhook',
    'prompt' => '<string>',
    'seed' => 1073741823
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/image-expand/ideogram"

	payload := strings.NewReader("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/image-expand/ideogram")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/image-expand/ideogram")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Ideogram 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 canvas	Actual output
896x1172	832x1088
1396x672	1472x704
896x896	1024x1024
4992x4768	1024x960

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

image-expand

ideogram

Ideogram - Expand image

curl --request POST \
  --url https://api.magnific.com/v1/ai/image-expand/ideogram \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "left": 1024,
  "right": 1024,
  "top": 1024,
  "bottom": 1024,
  "webhook_url": "https://www.example.com/webhook",
  "prompt": "<string>",
  "seed": 1073741823
}
'

import requests

url = "https://api.magnific.com/v1/ai/image-expand/ideogram"

payload = {
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "left": 1024,
    "right": 1024,
    "top": 1024,
    "bottom": 1024,
    "webhook_url": "https://www.example.com/webhook",
    "prompt": "<string>",
    "seed": 1073741823
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    left: 1024,
    right: 1024,
    top: 1024,
    bottom: 1024,
    webhook_url: 'https://www.example.com/webhook',
    prompt: '<string>',
    seed: 1073741823
  })
};

fetch('https://api.magnific.com/v1/ai/image-expand/ideogram', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/image-expand/ideogram",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'left' => 1024,
    'right' => 1024,
    'top' => 1024,
    'bottom' => 1024,
    'webhook_url' => 'https://www.example.com/webhook',
    'prompt' => '<string>',
    'seed' => 1073741823
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/image-expand/ideogram"

	payload := strings.NewReader("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/image-expand/ideogram")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/image-expand/ideogram")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"left\": 1024,\n  \"right\": 1024,\n  \"top\": 1024,\n  \"bottom\": 1024,\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"seed\": 1073741823\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

image

string<byte>

required

Base64 image to expand

left

integer

required

Number of pixels to expand on the left side

Required range: 0 <= x <= 2048

right

integer

required

Number of pixels to expand on the right side

Required range: 0 <= x <= 2048

top

integer

required

Number of pixels to expand on the top side

Required range: 0 <= x <= 2048

bottom

integer

required

Number of pixels to expand on the bottom side

Required range: 0 <= x <= 2048

webhook_url

string<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.

Example:

"https://www.example.com/webhook"

prompt

string

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

seed

integer

Optional seed for reproducibility

Required range: 0 <= x <= 2147483647

Response

OK - The task exists and the status is returned

data

object

required

Show child attributes

Example:

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

Get started

APIs

Ideogram - Expand image

Output size

Authorizations

Body

Response