Seedream

curl --request POST \
  --url https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "image": [
    {}
  ],
  "size": "<string>",
  "response_format": "<string>",
  "output_format": "<string>",
  "watermark": true,
  "stream": true
}
'

import requests

url = "https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "image": [{}],
    "size": "<string>",
    "response_format": "<string>",
    "output_format": "<string>",
    "watermark": True,
    "stream": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    image: [{}],
    size: '<string>',
    response_format: '<string>',
    output_format: '<string>',
    watermark: true,
    stream: true
  })
};

fetch('https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations', 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.highwayapi.ai/v3/bytedance/api/v3/images/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'image' => [
        [
                
        ]
    ],
    'size' => '<string>',
    'response_format' => '<string>',
    'output_format' => '<string>',
    'watermark' => true,
    'stream' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "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.highwayapi.ai/v3/bytedance/api/v3/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}")

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

	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.highwayapi.ai/v3/bytedance/api/v3/images/generations")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}"

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

POST

bytedance

api

images

generations

Seedream

curl --request POST \
  --url https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "image": [
    {}
  ],
  "size": "<string>",
  "response_format": "<string>",
  "output_format": "<string>",
  "watermark": true,
  "stream": true
}
'

import requests

url = "https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "image": [{}],
    "size": "<string>",
    "response_format": "<string>",
    "output_format": "<string>",
    "watermark": True,
    "stream": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    image: [{}],
    size: '<string>',
    response_format: '<string>',
    output_format: '<string>',
    watermark: true,
    stream: true
  })
};

fetch('https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations', 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.highwayapi.ai/v3/bytedance/api/v3/images/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'image' => [
        [
                
        ]
    ],
    'size' => '<string>',
    'response_format' => '<string>',
    'output_format' => '<string>',
    'watermark' => true,
    'stream' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "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.highwayapi.ai/v3/bytedance/api/v3/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}")

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

	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.highwayapi.ai/v3/bytedance/api/v3/images/generations")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.highwayapi.ai/v3/bytedance/api/v3/images/generations")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image\": [\n    {}\n  ],\n  \"size\": \"<string>\",\n  \"response_format\": \"<string>\",\n  \"output_format\": \"<string>\",\n  \"watermark\": true,\n  \"stream\": true\n}"

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

Die Parameter und deren Verwendung sind auf die offiziellen Vorgaben abgestimmt; detaillierte Parameter entnehmen Sie bitte direkt der offiziellen Dokumentation.

1. Übersicht

Die Seedream-Bildgenerierungs-API verwendet das OpenAI-artige Anfrageformat für die Bildgenerierung und unterstützt Text-zu-Bild, Bild-zu-Bild sowie Bildbearbeitung. Alle vier Modelle nutzen dieselbe Schnittstelle; der Client muss lediglich im Feld model des Anfrage-Bodys das gewünschte Modell auswählen.

Unterstützte Modelle

Client-Modell-ID	Modell	Ausgabeart
`seedream-4-0-250828`	Seedream 4.0	Einzelbild oder Bildserie
`seedream-4-5-251128`	Seedream 4.5	Einzelbild oder Bildserie
`seedream-5-0-260128`	Seedream 5.0 Lite	Einzelbild oder Bildserie
`dola-seedream-5-0-pro-260628`	Seedream 5.0 Pro	Einzelbild oder Ebenenaufteilung

2. Schnittstelle und Authentifizierung

POST https://{api_domain}/v3/bytedance/api/v3/images/generations

Anfrage-Header:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

Verwenden Sie für {api_domain} die API-Domain Ihrer Plattform. Die Anfrage muss mit POST gesendet werden, der Body muss JSON sein.

3. Anfrageparameter

3.1 Allgemeine Parameter

string

erforderlich

Verwenden Sie eine Modell-ID aus der obigen Tabelle.

string

erforderlich

Beschreibung des Bildes; Chinesisch und Englisch werden unterstützt.

string / string[]

URL eines Referenzbilds oder Base64-Data-URL. Sie können ein einzelnes Bild oder ein Array übergeben. Anzahl und Bildbeschränkungen richten sich nach den Grenzen des ausgewählten Modells.

string

Verwenden Sie eine vom Modell unterstützte Auflösungsstufe oder BreitexHöhe. Wird der Parameter nicht übergeben, gilt der Standardwert des Modells.

string

url oder b64_json, Standardwert ist url.

string

Wird nur von Seedream 5.0 Lite und 5.0 Pro unterstützt: jpeg oder png. Seedream 4.0 und 4.5 geben stets JPEG aus; die Übergabe von output_format wird abgelehnt.

boolean

Gibt an, ob ein KI-Generierungswasserzeichen hinzugefügt wird.

boolean

Der Bild-Endpunkt unterstützt keine Streaming-Ausgabe; übergeben Sie nicht true.

3.2 Modellabhängige Parameter

Parameter	Verwendbare Modelle	Beschreibung
`sequential_image_generation`	4.0, 4.5, 5.0 Lite	Schalter für die Generierung von Bildserien. Bei Bedarf gemäß dem Upstream-Protokoll des jeweiligen Modells ausfüllen; weglassen, wenn keine Bildserie erzeugt wird.
`sequential_image_generation_options`	4.0, 4.5, 5.0 Lite	Optionen für die Bildserien-Generierung, zusammen mit `sequential_image_generation` zu verwenden.
1K-, 1.5K- und 2K-Stufen von `size`	5.0 Pro	Pro unterstützt diese Stufen sowie explizite `BreitexHöhe`-Angaben. Pro unterstützt keine Bildserien-Parameter. Im Szenario der Ebenenaufteilung werden nur Stufen unterstützt (einschließlich auto); aktiviert wird sie über `layer_decomposition: true` (siehe Modellbeschränkungen).

Seedream 5.0 Pro unterstützt sequential_image_generation und sequential_image_generation_options nicht; die Übergabe eines dieser Felder wird abgelehnt. Senden Sie modellspezifische Parameter anderer Modelle nicht an Pro.

3.3 Beispiel für Text-zu-Bild

Die folgende Anfrage dient als Beispiel mit Seedream 5.0 Pro. Alle vier Modelle nutzen dieselbe Schnittstelle; bei Seedream 4.0 oder 4.5 muss output_format entfernt werden, das Feld darf nur bei Seedream 5.0 Lite/Pro übergeben werden:

curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "Ein Golden Retriever mit rotem Schal, bei natürlichem Licht an einem Bergsee vor schneebedeckten Bergen, filmische Fotografie",
    "size": "2K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": true
  }'

3.4 Beispiel für Bild-zu-Bild

image kann eine einzelne URL, eine einzelne Base64-Data-URL oder ein Array aus Zeichenketten sein:

{
  "model": "seedream-4-5-251128",
  "prompt": "Platzieren Sie die Person und die Kleidung aus dem Referenzbild in einer einheitlichen nächtlichen Stadtszene und bewahren Sie dabei die Merkmale der Person konsistent",
  "image": [
    "https://example.com/person.png",
    "https://example.com/outfit.png"
  ],
  "size": "2560x1440",
  "response_format": "url"
}

3.5 Beispiel für Bildserien (nur 4.0, 4.5 und 5.0 Lite)

Die Bildserien-Parameter gehören zu den ersten drei Modellen. Beispiel:

{
  "model": "seedream-5-0-260128",
  "prompt": "Erstellen Sie drei Poster der vier Jahreszeiten in einem einheitlichen Stil",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "response_format": "url"
}

Die verfügbaren Werte und Mengenbeschränkungen der Bildserien-Parameter entnehmen Sie bitte dem Upstream-Protokoll des ausgewählten Modells.

4. Antwort

Beispiel einer erfolgreichen Antwort:

{
  "created": 1786000000,
  "model": "seedream-4-5-251128",
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "2560x1440",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "input_images": 0
  }
}

Bei response_format=url wird data[].url zurückgegeben; bei response_format=b64_json wird data[].b64_json zurückgegeben.
Seedream 4.0, 4.5 und 5.0 Lite können im Bildserien-Modus mehrere data-Einträge zurückgeben.
Seedream 5.0 Pro gibt im Bildgenerierungs-Szenario einen data-Eintrag zurück; bei aktivierter Ebenenaufteilung werden mehrere data-Einträge zurückgegeben (ein Basisbild + mehrere Ebenen). Jeder Eintrag enthält zusätzlich die Stapelreihenfolge der Ebene z_index (Basisbild: 0), den Namen name, die Beschreibung description und das Begrenzungsrechteck bounding_box (mit absoluten / normalisierten Koordinaten; das Basisbild gibt dieses Feld nicht zurück).
model gibt die für diese Anfrage verwendete Client-Modell-ID zurück.
Die Gültigkeitsdauer der Bild-URLs wird von der Plattform und dem Upstream-Dienst bestimmt; laden und speichern Sie die Bilder bitte umgehend nach Erhalt.

5. Modellbeschränkungen

Seedream 4.0 / 4.5 / 5.0 Lite

Unterstützt Text-zu-Bild, Bild-zu-Bild und die Generierung von Bildserien.
Für Bildserien werden sequential_image_generation und das zugehörige options-Feld verwendet.
Anzahl der Eingabebilder, Bildgröße, Auflösung und Seitenverhältnis richten sich nach der Upstream-Dokumentation des jeweiligen Modells. Seedream 4.0 und 4.5 geben stets JPEG aus und unterstützen den Anfrageparameter output_format nicht; Seedream 5.0 Lite unterstützt jpeg und png.

Seedream 5.0 Pro

Unterstützt Text-zu-Bild, Bild-zu-Bild mit einem einzelnen Bild sowie die Verschmelzung mehrerer Bilder.
Im Bildgenerierungs-Szenario wird ein erfolgreich generiertes Bild zurückgegeben. Bei aktivierter Ebenenaufteilung (layer_decomposition: true) werden ein Basisbild und mehrere Ebenen (maximal 16 Ebenen) zurückgegeben; in diesem Fall enthält data mehrere Einträge. Die Generierung von Bildserien (sequential_image_generation) wird nicht unterstützt.
sequential_image_generation und sequential_image_generation_options werden nicht unterstützt.
Für size können 1K, 1.5K, 2K oder eine explizite BreitexHöhe-Angabe verwendet werden.
Bei expliziter Angabe von Breite und Höhe müssen Seitenverhältnis und Gesamtpixelzahl die Modellbeschränkungen erfüllen; die tatsächliche Größe des Ausgabebilds ergibt sich aus data[].size in der Antwort.
Ebenenaufteilung wird unterstützt: Bei layer_decomposition: true wird ein einzelnes Eingabebild in ein Basisbild und bis zu 16 unabhängig bearbeitbare Ebenen zerlegt (jede Ebene ist ein PNG mit Alpha-Kanal). In diesem Szenario ist image erforderlich, und es darf nur ein Bild übergeben werden; mehrere Bilder führen zu einem Fehler. Die Ebenenaufteilung folgt dem Alles-oder-nichts-Prinzip: Schlägt eine einzige Ebene fehl, schlägt die gesamte Anfrage fehl; Teilerfolge werden nicht unterstützt.
size-Regeln für die Ebenenaufteilung: Die Auflösung des Basisbilds entspricht size; die Auflösung der einzelnen Ebenen liegt nahe an size, wobei jede Ebene das Seitenverhältnis ihres jeweiligen Bereichs im Originalbild beibehält, sodass die tatsächliche Pixelzahl der Ebenen unterschiedlich ausfällt. Dies bedeutet, dass die Ausgabebilder derselben Anfrage in unterschiedliche Pixel-Preisstufen fallen können. Für size sind 1K, 1.5K, 2K und auto möglich; Standard ist auto.

6. Abrechnung und Nutzung

4.0, 4.5 und 5.0 Lite werden nach der Anzahl der erfolgreich generierten Bilder abgerechnet; bei der Generierung von Bildserien zählt die tatsächlich erfolgreiche Anzahl der Ausgaben.
5.0 Pro wird nach erfolgreich ausgegebenen Bildern abgerechnet; bei mehreren Eingabebildern ist das erste Referenzbild kostenlos, zusätzliche Referenzbilder werden separat erfasst. Unterschiedliche Ausgabegrößen entsprechen unterschiedlichen Preisstufen. Bei aktivierter Ebenenaufteilung zählen das Basisbild und jede Ebene jeweils als ein erfolgreich ausgegebenes Bild und werden anhand der Pixel von data[].size der entsprechenden Preisstufe zugeordnet und separat abgerechnet (z. B. das Basisbild in einer Stufe mit hohen Pixelzahlen, einzelne Ebenen in Stufen mit niedrigeren Pixelzahlen); die endgültige Abrechnung ergibt sich aus der Summe der Mengen je Stufe.
Die Nutzungseinheit ist „Bild“ bzw. item.
Die genauen Preise entnehmen Sie bitte der Produkt-Preisseite Ihrer Plattform.

7. Fehlerbehebung

Szenario	Empfehlung
Modell nicht unterstützt	Prüfen Sie, ob `model` exakt mit der obigen Tabelle übereinstimmt.
Prompt fehlt	Der Body muss einen nicht leeren Prompt enthalten.
Bild kann nicht gelesen werden	Prüfen Sie Erreichbarkeit, Format, Größe und Pixelbeschränkungen der URL.
`stream=true`	Der Bild-Endpunkt unterstützt keine Streaming-Ausgabe; entfernen Sie das Feld oder setzen Sie es auf `false`.
Pro erhält Bildserien-Felder	Entfernen Sie die beiden Felder `sequential_image_generation*`.
size ungültig	Verwenden Sie eine vom ausgewählten Modell unterstützte Stufe oder eine `BreitexHöhe`-Angabe innerhalb der Beschränkungen.

API-Grundlagen

Große Sprachmodelle

Bilder

Video

Audio

Seedream

1. Übersicht

Unterstützte Modelle

2. Schnittstelle und Authentifizierung

3. Anfrageparameter

3.1 Allgemeine Parameter

3.2 Modellabhängige Parameter

3.3 Beispiel für Text-zu-Bild

3.4 Beispiel für Bild-zu-Bild

3.5 Beispiel für Bildserien (nur 4.0, 4.5 und 5.0 Lite)

4. Antwort

5. Modellbeschränkungen

Seedream 4.0 / 4.5 / 5.0 Lite

Seedream 5.0 Pro

6. Abrechnung und Nutzung

7. Fehlerbehebung

​1. Übersicht

​Unterstützte Modelle

​2. Schnittstelle und Authentifizierung

​3. Anfrageparameter

​3.1 Allgemeine Parameter

​3.2 Modellabhängige Parameter

​3.3 Beispiel für Text-zu-Bild

​3.4 Beispiel für Bild-zu-Bild

​3.5 Beispiel für Bildserien (nur 4.0, 4.5 und 5.0 Lite)

​4. Antwort

​5. Modellbeschränkungen

​Seedream 4.0 / 4.5 / 5.0 Lite

​Seedream 5.0 Pro

​6. Abrechnung und Nutzung

​7. Fehlerbehebung

1. Übersicht

Unterstützte Modelle

2. Schnittstelle und Authentifizierung

3. Anfrageparameter

3.1 Allgemeine Parameter

3.2 Modellabhängige Parameter

3.3 Beispiel für Text-zu-Bild

3.4 Beispiel für Bild-zu-Bild

3.5 Beispiel für Bildserien (nur 4.0, 4.5 und 5.0 Lite)

4. Antwort

5. Modellbeschränkungen

Seedream 4.0 / 4.5 / 5.0 Lite

Seedream 5.0 Pro

6. Abrechnung und Nutzung

7. Fehlerbehebung