Seedream 5.5

Użyj modelu doubao-seedream-5-5-261028 z POST https://apimaster.ai/v1/images/generations, ciałem JSON i Authorization: Bearer YOUR_API_KEY. Utwórz swój klucz APIMaster w konsoli.

Obsługuje generowanie obrazu z tekstu, edycję z maksymalnie dziesięcioma referencjami, kolejne edycje, natywne przezroczyste wyjście RGBA, dekompozycję warstw i OCR tekstu sformatowanego. Normalne generowanie zwraca jeden obraz. Dekompozycja zwraca podstawę i oddzielne warstwy. Strumieniowanie, sekwencyjne generowanie obrazów i wyszukiwanie w sieci nie są obsługiwane. Użyj punktu końcowego synchronicznego; pozostaw co najmniej 300 sekund przed przekroczeniem limitu czasu klienta i unikaj ponownego przesyłania na ślepo.

Oficjalne ceny podstawowe

Sprawdzono według cennika Volcengine dnia 2026-11-13. Skonfigurowany kurs przeliczeniowy wynosił 7 CNY za USD.

Pozycja	CNY za obraz	Przybliżona bazowa cena USD
Każda referencja wejściowa, w tym pierwsza	0.05	0.00714286
Wyjście o szerokości × wysokości ≤ 2,610,000 pikseli	0.13	0.01857143
Wyjście powyżej 2,610,000 pikseli	0.23	0.03285714

Generowanie i dekompozycja używają tych samych stawek wyjściowych. Naliczaj każdą podstawę/warstwę osobno, używając jej rzeczywistego data[].size; najdłuższa krawędź nie decyduje o poziomie. 2048x1024 znajduje się w niższym poziomie. Dwa wejścia plus jedno wyjście wysokiego poziomu kosztują CNY 0.33 przed mnożnikami konta/kanału. W przeciwieństwie do Seedream 5.0 Pro, pierwsza referencja nie jest darmowa. Rzeczywiste opłaty na koncie obejmują odpowiednie współczynniki kanału/grupy użytkowników i zaokrąglanie całkowitego limitu. Zobacz kartę modelu na żywo i dzienniki użycia.

Generowanie obrazu z tekstu

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Parametry

Pole	Typ / domyślnie	Zasady
model	wymagany ciąg znaków	doubao-seedream-5-5-261028.
prompt	ciąg znaków	Wymagane do generowania; opcjonalne do dekompozycji. Opisz zawartość, styl, proporcje, tekst lub miejsce edycji. Oficjalne wytyczne dotyczące pisania zalecają ≤300 znaków chińskich lub ≤600 angielskich słów; to wskazówka, a nie limit bajtów.
image	ciąg znaków lub ciąg znaków[]	Publiczny URL lub data:image/png;base64,.... Do dziesięciu referencji generowania; dokładnie jedno wejście dla dekompozycji. Lokalne ścieżki systemu plików nie działają.
size	ciąg znaków	Generowanie domyślnie ustawia 2K; 1K, 1.5K, 2K lub dokładnie WIDTHxHEIGHT. Dekompozycja domyślnie ustawia auto, akceptuje tylko auto i te trzy poziomy.
output_format	ciąg znaków, png	png lub jpeg. W przypadku dekompozycji to kontroluje tylko podstawę; warstwy są zawsze PNG.
background	ciąg znaków, auto	auto, transparent lub opaque, tylko do generowania. Przezroczyste wyjście wymaga PNG; pomiń to pole całkowicie w przypadku dekompozycji.
response_format	ciąg znaków, url	url lub b64_json. Odczytaj pasujące pole w każdym elemencie data[].
watermark	wartość logiczna, true	Ustaw false, aby pominąć widoczny znak wodny generowany przez AI.
optimize_prompt_options	obiekt	Tylko {"mode":"standard"} jest obsługiwany przez 5.5; fast nie jest obsługiwany.
layer_decomposition	wartość logiczna, false	Włącz dekompozycję jednego obrazu PNG/JPEG.
layer_decomposition_options	obiekt	Opcje dekompozycji poniżej.
layer_decomposition_options.max_images	liczba całkowita, 30	2–100, w tym podstawa. Maksimum, a nie gwarantowana liczba.
layer_decomposition_options.text_recognition	wartość logiczna, false	Zażądaj OCR tekstu sformatowanego dla zwykłych warstw tekstowych.
safety_identifier	ciąg znaków	Stały angielski identyfikator użytkownika, co najwyżej 64 znaków; użyj skrótu zamiast danych kontaktowych.

Nie używaj resolution, quality, n ani seed innego modelu do kontrolowania tego modelu. Nie są one wymienione jako odpowiadające mu kontrolki generowania w oficjalnym API. Ustaw limity dekompozycji za pomocą layer_decomposition_options.max_images.

Rozmiary i ograniczenia wejściowe

Dla zwykłego generowania wybierz poziom (1K, 1.5K, 2K) i opisz proporcje w prompcie lub podaj dokładne wymiary. Dokładny obszar wyjściowy musi wynosić 921,600–4,624,220 pikseli, z proporcjami 1:16–16:1, spełniając oba ograniczenia. 2880x1440 jest prawidłowe; 512x512 jest za małe. Nie ma poziomu 4K.

Dekompozycja nie akceptuje dokładnych wymiarów. W przypadku auto rozmiary podstawy/warstwy w obsługiwanym zakresie zachowują swoje oryginalne wymiary, jeśli to możliwe; mniejsze/większe elementy skalują się w kierunku 1K/2K, zachowując swoje proporcje. Zwrócone warstwy mogą zajmować różne poziomy rozliczeniowe.

Ograniczenie wejściowe	Generowanie/edycja	Dekompozycja
Liczba	Do 10	Dokładnie 1
Formaty	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Rozmiar pliku na obraz	≤30 MB	≤30 MB
Obszar pikseli	196–36,000,000; obie strony >14 px	262,144–36,000,000
Proporcje	1:16–16:1	1:16–16:1

Używaj małych liter w typach MIME w adresach URL danych. Zdalne adresy URL wejściowe muszą być dostępne dla usługi.

Edycja i przezroczyste obrazy

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Dla jednego wejścia image może być ciągiem znaków. W przypadku kolejnych edycji jawnie przekaż poprzednie wyjście jako następne wejście: to nie jest konwersacja stanowa, a każde żądanie jest rozliczane osobno. Opisz współrzędne/pola/strzałki w prompcie lub narysuj znaczniki na referencji; nie ma oddzielnego udokumentowanego parametru pozycjonowania mask dla tego interfejsu.

W przypadku natywnego generowania przezroczystości pomiń image, jeśli nie jest konieczne, i ustaw background: "transparent", output_format: "png", z promptem takim jak „półprzezroczysty niebieski szklany motyl, izolowany zasób, przezroczyste tło”. Edycja może używać do dziesięciu referencji; nie muszą one mieć już kanałów alfa. transparent plus jpeg jest nieprawidłowe. background odpowiedzi opisuje rzeczywistą przezroczystość (transparent lub opaque).

Dekompozycja i OCR tekstu sformatowanego

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Obsługuje jedną podstawę plus do 99 warstw. max_images: 4 obejmuje podstawę. Pomiń background; każda warstwa jest przezroczystym PNG. Awaria pojedynczej warstwy powoduje niepowodzenie całego żądania, zamiast zwracania częściowego sukcesu.

Odczytaj wszystkie wpisy data[]:

• url/b64_json, size i output_format identyfikują artefakt i jego rzeczywiste wymiary; background jest dostępny, gdy ma zastosowanie.
• z_index: 0 identyfikuje podstawę; większe indeksy pojawiają się nad mniejszymi.
• name i description opisują warstwę.
• bounding_box.absolute to [left,top,right,bottom] w pikselach podstawy wyjściowej. Zmień rozmiar warstwy na (right-left) × (bottom-top) i umieść ją w (left,top); wymiary pliku warstwy mogą różnić się od jej śladu na kanwie.
• bounding_box.normalized używa współrzędnych 0–1000. Pomnóż współrzędne poziome/pionowe przez szerokość/wysokość docelowej kanwy i podziel przez 1000.
• text_recognition pojawia się tylko na żądanie i gdy warstwa zawiera rozpoznany zwykły tekst. Pismo odręczne, liternictwo artystyczne i warstwy nietekstowe mogą go pomijać.

OCR zawiera text i lines[]; każda linia ma własny bounding_box i stylizowany runs[]. Każdy fragment ma text i style, które mogą zawierać similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow i translucent. Są to przybliżone interpretacje wizualne, a nie dokładne oryginalne właściwości projektu; rozpoznawanie czcionek może zwrócić unknown.

Odpowiedź, przechowywanie i awarie

Odpowiedź zawiera created, model, data[], usage.input_images i usage.generated_images. Wygenerowana liczba obejmuje podstawę i warstwy. Zachowaj kompletne metadane odpowiedzi. Oryginalne adresy URL pobierania od dostawcy wygasają po 24 godzinach; niezwłocznie pobierz/zarchiwizuj swoje zasoby.

Popraw nieprawidłowe wymiary, liczby referencji lub niekompatybilne opcje przezroczystości przed ponowną próbą. Obsługuj uwierzytelnianie, uprawnienia, moderację, limity szybkości i awarie nadrzędne osobno; nigdy nie interpretuj błędu jako udanego generowania. Limity IPM liczą wygenerowane obrazy na konto/wersję modelu; dekompozycja rezerwuje max_images i zwraca niewykorzystaną pojemność po zakończeniu, podczas gdy rozliczanie używa rzeczywiście wyprodukowanych obrazów.

Oficjalne źródła: Seedream 5.5, API generowania obrazów, cennik. Parametry sprawdzono 2026-11-13.