Flux Pro - Expand image

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

import requests

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

payload = {
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "webhook_url": "https://www.example.com/webhook",
    "prompt": "<string>",
    "left": 512,
    "right": 512,
    "top": 256,
    "bottom": 256
}
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=',
    webhook_url: 'https://www.example.com/webhook',
    prompt: '<string>',
    left: 512,
    right: 512,
    top: 256,
    bottom: 256
  })
};

fetch('https://api.magnific.com/v1/ai/image-expand/flux-pro', 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/flux-pro",
  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=',
    'webhook_url' => 'https://www.example.com/webhook',
    'prompt' => '<string>',
    'left' => 512,
    'right' => 512,
    'top' => 256,
    'bottom' => 256
  ]),
  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/flux-pro"

	payload := strings.NewReader("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\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/flux-pro")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\n}"

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

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

Flux Pro Image Expand

Flux Pro - Expand image

This endpoint allows you to expand an image using the AI Flux Pro model. The image will be expanded based on the provided parameters.

Input size

The image you send must be at least 256 pixels on each side and no larger than 20 megapixels (width * height <= 20,000,000). Neither side is capped on its own and there is no aspect ratio restriction: a 30000x600 image is accepted, while a 255x70500 one is rejected because one of its sides is below 256, even though it is only 18 megapixels.

File size is irrelevant — what counts is the decoded pixel count, so a heavily compressed 60 megapixel photo is rejected just the same. An image outside these bounds is rejected with an error naming the rule it broke.

Sending more than 20 megapixels buys you nothing anyway: the output is capped at roughly 1.6 megapixels regardless of how large the input was, so resize before uploading.

Output size

left, right, top and bottom describe the expansion you are asking for, but this model does not guarantee that exact output size. The requested canvas is input_width + left + right by input_height + top + bottom, and two rules are then applied to it:

Maximum output size of roughly 1.6 megapixels. If the requested canvas is larger, the whole image is scaled down proportionally until it fits. The aspect ratio is preserved, so there is no single maximum width or height: the cap applies to the total pixel count. A 1200x400 image expanded by 400 pixels on each edge asks for a 2000x1200 canvas and comes back as 1632x976.
Each side is rounded to the nearest multiple of 16. A requested 916x692 comes back as 912x688; a requested 936x712 comes back as 944x720.

Both rules apply on every request, including small ones, so an output that matches your requested pixels exactly is the exception rather than the rule.

Omitting an edge applies its default (512 left, 512 right, 256 top, 256 bottom). Sending 0 leaves that edge unexpanded; sending 0 on all four edges returns a 400, since there is nothing to expand.

That said, this is the expand endpoint that stays closest to the pixel values you request: below the 1.6 megapixel cap, the rounding to 16 is the only deviation. Expanding an 896x672 image by 500 pixels on the top edge alone asks for 896x1172 and returns 896x1168. The other two expand endpoints diverge much further: ideogram always renders at about 1 megapixel and only preserves the aspect ratio, and seedream-v4-5 scales any canvas below 3.7 megapixels up. If you need exact output dimensions, resize the result yourself after generation.

POST

image-expand

flux-pro

Flux Pro - Expand image

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

import requests

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

payload = {
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "webhook_url": "https://www.example.com/webhook",
    "prompt": "<string>",
    "left": 512,
    "right": 512,
    "top": 256,
    "bottom": 256
}
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=',
    webhook_url: 'https://www.example.com/webhook',
    prompt: '<string>',
    left: 512,
    right: 512,
    top: 256,
    bottom: 256
  })
};

fetch('https://api.magnific.com/v1/ai/image-expand/flux-pro', 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/flux-pro",
  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=',
    'webhook_url' => 'https://www.example.com/webhook',
    'prompt' => '<string>',
    'left' => 512,
    'right' => 512,
    'top' => 256,
    'bottom' => 256
  ]),
  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/flux-pro"

	payload := strings.NewReader("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\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/flux-pro")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"prompt\": \"<string>\",\n  \"left\": 512,\n  \"right\": 512,\n  \"top\": 256,\n  \"bottom\": 256\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

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

The description of the changes you want to make. This text guides the expansion process, allowing you to specify features, styles, or modifications for the expanded areas.

left

integer | null

default:512

Pixels to expand on the left. Omit the field to use the default of 512; send 0 to leave this edge unexpanded. The requested size is not always the size you get back — see the description of this endpoint.

Required range: 0 <= x <= 2048

right

integer | null

default:512

Pixels to expand on the right. Omit the field to use the default of 512; send 0 to leave this edge unexpanded.

Required range: 0 <= x <= 2048

top

integer | null

default:256

Pixels to expand on the top. Omit the field to use the default of 256; send 0 to leave this edge unexpanded.

Required range: 0 <= x <= 2048

bottom

integer | null

default:256

Pixels to expand on the bottom. Omit the field to use the default of 256; send 0 to leave this edge unexpanded.

Required range: 0 <= x <= 2048

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

Flux Pro - Expand image

Input size

Output size

Authorizations

Body

Response