Seedream V4.5 - Expand image

curl --request POST \
  --url https://api.magnific.com/v1/ai/image-expand/seedream-v4-5 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "image": "<string>",
  "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/seedream-v4-5"

payload = {
    "image": "<string>",
    "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: '<string>',
    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/seedream-v4-5', 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/seedream-v4-5",
  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' => '<string>',
    '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/seedream-v4-5"

	payload := strings.NewReader("{\n  \"image\": \"<string>\",\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/seedream-v4-5")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"<string>\",\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/seedream-v4-5")

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\": \"<string>\",\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"
  }
}

Seedream V4.5 Image Expand

Seedream V4.5 - Expand image

This endpoint allows you to expand an image using the Seedream V4.5 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

The requested canvas is input_width + left + right by input_height + top + bottom, and this model constrains it in two ways:

Each side is rounded up to the next multiple of 16.
The canvas must contain between 3,686,400 and 16,777,216 pixels. A smaller canvas is scaled up to reach the lower bound, and a larger one is scaled down to the upper bound. Since the lower bound is close to 3.7 megapixels, a small input with a small expansion is upscaled — a 896x672 image expanded by 100px on each edge asks for a 1096x872 canvas and comes back at 2160x1728, close to twice the requested dimensions (measured).

If you need the output to stay close to the pixel values you requested, use POST /v1/ai/image-expand/flux-pro, which only deviates by the rounding to 16 while the result stays under 1.6 megapixels. For exact dimensions, resize the result yourself after generation.

left, right, top and bottom are all required, and at least one of them must be greater than 0.

POST

image-expand

seedream-v4-5

Seedream V4.5 - Expand image

curl --request POST \
  --url https://api.magnific.com/v1/ai/image-expand/seedream-v4-5 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "image": "<string>",
  "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/seedream-v4-5"

payload = {
    "image": "<string>",
    "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: '<string>',
    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/seedream-v4-5', 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/seedream-v4-5",
  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' => '<string>',
    '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/seedream-v4-5"

	payload := strings.NewReader("{\n  \"image\": \"<string>\",\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/seedream-v4-5")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"image\": \"<string>\",\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/seedream-v4-5")

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\": \"<string>\",\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

required

Image to expand. Accepts an HTTPS URL or a Base64-encoded image (max 10MB).

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

Seedream V4.5 - Expand image

Output size

Authorizations

Body

Response