Seedream Image Generation
curl --request POST \
--url https://api.sinancode.com/v1/generate/vol/seedream \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
"images": [
"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
],
"max_images": 4,
"size": "2K",
"version": "5.0-lite"
}
'import requests
url = "https://api.sinancode.com/v1/generate/vol/seedream"
payload = {
"prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
"images": ["https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"],
"max_images": 4,
"size": "2K",
"version": "5.0-lite"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '把这张照片变成黏土风格。放在一张拍立得照片中...',
images: ['https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png'],
max_images: 4,
size: '2K',
version: '5.0-lite'
})
};
fetch('https://api.sinancode.com/v1/generate/vol/seedream', 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.sinancode.com/v1/generate/vol/seedream",
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' => '把这张照片变成黏土风格。放在一张拍立得照片中...',
'images' => [
'https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png'
],
'max_images' => 4,
'size' => '2K',
'version' => '5.0-lite'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sinancode.com/v1/generate/vol/seedream"
payload := strings.NewReader("{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.sinancode.com/v1/generate/vol/seedream")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sinancode.com/v1/generate/vol/seedream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "01234567-89ab-cdef-0123-456789abcdef"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}Image Generation - Seedream
Seedream Image Generation
Generate images using Volcano Engine’s Seedream model, supporting single-image and batch modes, with optional versions 4.0, 4.5, or 5.0-lite (synchronous).
- max_images = 1: Generate a single image.
- max_images > 1: Generate a batch of images, up to N images.
- max_images not set: Automatic batch mode, up to 15 images.
POST
/
generate
/
vol
/
seedream
Seedream Image Generation
curl --request POST \
--url https://api.sinancode.com/v1/generate/vol/seedream \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
"images": [
"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
],
"max_images": 4,
"size": "2K",
"version": "5.0-lite"
}
'import requests
url = "https://api.sinancode.com/v1/generate/vol/seedream"
payload = {
"prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
"images": ["https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"],
"max_images": 4,
"size": "2K",
"version": "5.0-lite"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '把这张照片变成黏土风格。放在一张拍立得照片中...',
images: ['https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png'],
max_images: 4,
size: '2K',
version: '5.0-lite'
})
};
fetch('https://api.sinancode.com/v1/generate/vol/seedream', 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.sinancode.com/v1/generate/vol/seedream",
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' => '把这张照片变成黏土风格。放在一张拍立得照片中...',
'images' => [
'https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png'
],
'max_images' => 4,
'size' => '2K',
'version' => '5.0-lite'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sinancode.com/v1/generate/vol/seedream"
payload := strings.NewReader("{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.sinancode.com/v1/generate/vol/seedream")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sinancode.com/v1/generate/vol/seedream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"把这张照片变成黏土风格。放在一张拍立得照片中...\",\n \"images\": [\n \"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png\"\n ],\n \"max_images\": 4,\n \"size\": \"2K\",\n \"version\": \"5.0-lite\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "01234567-89ab-cdef-0123-456789abcdef"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}Generate images using ByteDance’s Seedream model, supporting both single image and multi-image modes.
Key Features:
- Multi-Version Support - Supports 5.0-lite (default), 4.5, and 4.0
- Flexible Output Modes - Single image (
max_images=1) or multi-image (max_images=2-15) - Text-to-Image & Image-to-Image - Generate from text or reference images (up to 14)
- HD Output - 5.0-lite supports 2K/3K, 4.5/4.0 supports 2K/4K, or specify exact resolution
Authorizations
Please use your API Token for authentication
Body
application/json
Task parameters
Prompt (required, recommended not to exceed 300 Chinese characters or 600 English words)
Required string length:
1 - 2000Example:
"把这张照片变成黏土风格。放在一张拍立得照片中..."
Input images (optional, supports multiple reference images, up to 14) Example: ["https://example.com/1.jpg", "https://example.com/2.jpg"]
Example:
[
"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
]
Maximum number of images (optional, default 1)
- Set to 1: Generate a single image (disables group image function)
- Set to 2-15: Generate a group of images, up to N images (input image count + generated count ≤ 15)
Required range:
1 <= x <= 15Example:
4
Image size (optional, default 2K) Two formats are supported:
- Tier: 2K, 3K (for 5.0-lite) or 2K, 4K (for 4.5/4.0), where the model automatically determines the aspect ratio based on the prompt
- Exact resolution: width x height, e.g., "2048x2048", "2560x1440"
Example:
"2K"
Model version (optional, default 5.0-lite) Available values: 4.0, 4.5, 5.0-lite
Available options:
4.0, 4.5, 5.0-lite Example:
"5.0-lite"
Response
OK
Task ID
Example:
"01234567-89ab-cdef-0123-456789abcdef"