curl --request POST \
--url https://api.magnific.com/v1/ai/text-to-image/seedream-v4 \
--header 'Content-Type: application/json' \
--header 'x-magnific-api-key: <api-key>' \
--data '
{
"prompt": "<string>",
"webhook_url": "https://www.example.com/webhook",
"aspect_ratio": "square_1_1",
"guidance_scale": 2.5,
"seed": 1073741823
}
'import requests
url = "https://api.magnific.com/v1/ai/text-to-image/seedream-v4"
payload = {
"prompt": "<string>",
"webhook_url": "https://www.example.com/webhook",
"aspect_ratio": "square_1_1",
"guidance_scale": 2.5,
"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({
prompt: '<string>',
webhook_url: 'https://www.example.com/webhook',
aspect_ratio: 'square_1_1',
guidance_scale: 2.5,
seed: 1073741823
})
};
fetch('https://api.magnific.com/v1/ai/text-to-image/seedream-v4', 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/text-to-image/seedream-v4",
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([
'prompt' => '<string>',
'webhook_url' => 'https://www.example.com/webhook',
'aspect_ratio' => 'square_1_1',
'guidance_scale' => 2.5,
'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/text-to-image/seedream-v4"
payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\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/text-to-image/seedream-v4")
.header("x-magnific-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\n \"seed\": 1073741823\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.magnific.com/v1/ai/text-to-image/seedream-v4")
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 \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\n \"seed\": 1073741823\n}"
response = http.request(request)
puts response.read_bodySeedream 4 - Create image from text
Convert descriptive text input into images using AI. This endpoint accepts a variety of parameters to customize the generated images.
curl --request POST \
--url https://api.magnific.com/v1/ai/text-to-image/seedream-v4 \
--header 'Content-Type: application/json' \
--header 'x-magnific-api-key: <api-key>' \
--data '
{
"prompt": "<string>",
"webhook_url": "https://www.example.com/webhook",
"aspect_ratio": "square_1_1",
"guidance_scale": 2.5,
"seed": 1073741823
}
'import requests
url = "https://api.magnific.com/v1/ai/text-to-image/seedream-v4"
payload = {
"prompt": "<string>",
"webhook_url": "https://www.example.com/webhook",
"aspect_ratio": "square_1_1",
"guidance_scale": 2.5,
"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({
prompt: '<string>',
webhook_url: 'https://www.example.com/webhook',
aspect_ratio: 'square_1_1',
guidance_scale: 2.5,
seed: 1073741823
})
};
fetch('https://api.magnific.com/v1/ai/text-to-image/seedream-v4', 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/text-to-image/seedream-v4",
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([
'prompt' => '<string>',
'webhook_url' => 'https://www.example.com/webhook',
'aspect_ratio' => 'square_1_1',
'guidance_scale' => 2.5,
'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/text-to-image/seedream-v4"
payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\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/text-to-image/seedream-v4")
.header("x-magnific-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\n \"seed\": 1073741823\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.magnific.com/v1/ai/text-to-image/seedream-v4")
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 \"prompt\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\",\n \"aspect_ratio\": \"square_1_1\",\n \"guidance_scale\": 2.5,\n \"seed\": 1073741823\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Your Magnific API key. Required for authentication. Learn how to obtain an API key
Body
The text prompt used to generate the image
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.
"https://www.example.com/webhook"
The aspect ratio of the generated image
square_1_1, widescreen_16_9, social_story_9_16, portrait_2_3, traditional_3_4, standard_3_2, classic_4_3 Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation.
0 <= x <= 20Random seed to control the stochasticity of image generation
0 <= x <= 2147483647Response
OK - The request has succeeded and the Seedream v4 process has started.
Show child attributes
Show child attributes
{ "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91", "status": "CREATED", "generated": [ "https://openapi-generator.tech", "https://openapi-generator.tech" ] }
Was this page helpful?