Edycja w Seedream 4.0: role referencji, dokładne rozmiary i obrazy po 0,03 $

Edycja w Seedream 4.0 przyjmuje od 1 do 10 obrazów referencyjnych i zwraca jeden obraz w rozmiarze wybranym spośród szesnastu gotowych ustawień. Kosztuje 0,03 $ za obraz przy każdym rozmiarze i każdej liczbie referencji. Nie ma maski, suwaka siły ani seeda, więc całą kontrolę niesie prompt: używaj go do zmiany ubioru, tła i światła albo do zamiany szkicu w render, a nie do edycji, w których każdy inny piksel ma pozostać nietknięty.

SpicyAPI nie dodaje do tego edytora żadnego dodatkowego filtra treści na poziomie platformy. W naszych testach z września 2026 edycje dla dorosłych o wyższej intensywności czasem wracały łagodniejsze, niż prosiliśmy, mimo że zadanie wyświetlało się jako zakończone powodzeniem, więc sprawdź obraz, zanim go użyjesz.

Daj każdej referencji zadanie

Prześlij obrazy w image_urls i odwołuj się do nich po kolei: obraz pierwszy, obraz drugi i tak dalej. Referencja, której nie wymienisz, nie jest ignorowana, tylko wmieszana w wynik. Daj każdemu źródłu jedno zadanie i napisz, co ma przetrwać.

Do zmiany garderoby wgraj zatwierdzony obraz fikcyjnej dorosłej osoby w prostej kurtce, wybierz 1728*2304 i użyj:

Zachowaj z obrazu pierwszego twarz, fryzurę, pozę, dłonie, widok kamery i tło fikcyjnej dorosłej osoby. Zamień tylko kurtkę na nieprzezroczystą bordową aksamitną marynarkę noszoną na istniejącej kremowej koszuli. Zachowaj pierwotną długość kurtki i kształt ramion. Pokaż miękki połysk aksamitu w istniejącym świetle, z wyraźnymi klapami, bez nowej biżuterii i tekstu.

Polecenie „zrób strój bardziej luksusowy” zostawia krój otwarty i może zwrócić zupełnie inny kostium. Aby dopasować konkretną marynarkę, dodaj ją jako obraz drugi i zmień zdanie o materiale na: „Obraz drugi określa krój, klapy i tkaninę bordowej marynarki. Użyj tylko tego ubioru; osobę, pozę i scenę zachowaj z obrazu pierwszego.” Przytnij zdjęcie ubioru do samej odzieży, bo pełne zdjęcie modowe przynosi ze sobą także twarz, ciało i oświetlenie.

SpicyAPI przyjmuje do dziesięciu referencji. Każdy plik może być JPG, PNG, WEBP lub GIF do 10 MB, dla obrazów, do których masz prawa.

Wybierz dokładny rozmiar

Seedream 4.0 przyjmuje size jako ciąg width*height, a nie pola resolution i aspect_ratio znane z modeli 5.0. Domyślnie jest to 2048*2048. Wynik jest budowany od nowa w wybranym ustawieniu, a nie wycinany ze źródła, więc pionowe źródło wysłane z domyślnym kwadratem zostaje skomponowane na nowo i jego kadr może się zmienić. Dopasuj rozmiar do kształtu źródła.

1024*1024 to ostatnie dostępne ustawienie. Inne wymiary są odrzucane. 4096*2304 to największy kadr wśród edytorów Seedream w SpicyAPI; 5.0 Lite sięga najwyżej 3136*1344.

Nie ma ustawienia 4:5. Dla karty 4:5 do mediów społecznościowych użyj 1728*2304 i zostaw zapas na lekkie przycięcie albo przejdź na Seedream 5.0 Flash (0,029 $ za obraz) lub 5.0 Pro, które przyjmują aspect_ratio: 4:5. Pro zaczyna się od 0,036 $ za obraz i kosztuje więcej w 2K oraz z dodatkowymi referencjami.

Najpierw wypróbuj w Playground

Uruchom edycję w Playground, zanim napiszesz kod: wynik, który tu jest zły, będzie zły także przez API, a rozwiązaniem jest lepszy prompt lub lepsza referencja.

1. Otwórz stronę edycji Seedream 4.0 i zostań na karcie Playground w widoku Form. Aby uruchomić, zaloguj się na konto z doładowanym saldem.
2. Dodaj źródła w sekcji Images: upuść plik lub wklej link przez Add URL. Do 10; kolejność dodawania to „obraz pierwszy”, „obraz drugi”.
3. Opisz zmianę w polu Prompt, wskazując, co wnosi każdy obraz i co ma przetrwać.
4. Wybierz Output size pasujący do kształtu źródła.
5. Sprawdź szacowaną cenę i uruchom. Widok JSON pokazuje treść żądania, którą możesz skopiować do kodu.

Potem wywołaj z kodu

Zainstaluj SDK Pythona (pip install spicyapi), ustaw SPICY_API_KEY w środowisku serwera i uruchom:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="bytedance/seedream-4.0/edit",
    input_data={
        "image_urls": [
            "https://example.com/person.png",
            "https://example.com/blazer.png",
        ],
        "prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
        "size": "1728*2304",
    },
    idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"])  # copy it to your own storage now

Zastąp dwa przykładowe adresy URL własnymi; muszą być dostępne bez logowania, albo wgraj plik lokalny i przekaż zwrócony URI spicy://. Link do wyniku wygasa po około 20 minutach (szczegóły dotyczące przechowywania). Wyceny, przesyłanie plików, oczekiwanie, ponowienia i błędy opisano w dokumentacji SDK Pythona i w przewodniku po zadaniach asynchronicznych.

Albo pozwól uruchomić to agentowi

Jeśli asystent ma wykonywać edycje za Ciebie, daj mu CLI, serwer MCP lub Skill. CLI i serwer MCP pokazują cenę i pytają przed płatnym wywołaniem.

• CLI. Umieść ten sam obiekt input w pliku input.json, a następnie uruchom poniższe polecenie (npx @spicyapi/cli działa bez instalacji; zobacz dokumentację CLI):

``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``

• Serwer MCP. Dodaj serwer MCP do swojego asystenta, a potem poproś: „Edytuj ./portrait.png w Seedream 4.0: zamień tylko kurtkę na bordową aksamitną marynarkę, rozmiar 1728*2304.” Wywołuje on spicyapi_upload_file, potem spicyapi_task_create, które zatrzymuje się na potwierdzenie ceny, a następnie spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instaluje Agent Skill, dzięki któremu asystent programistyczny czyta aktualny schemat modelu zamiast zgadywać pola.

Zamień szkic w koncepcję materiałową

Połóż szkic na pierwszym miejscu, a próbkę materiału na drugim i powiedz, co należy do którego. Przykład z fikcyjnym zegarem:

Zamień szkic zegara z obrazu pierwszego w realistyczną koncepcję produktu. Zachowaj ciągłą łukową obudowę, wyśrodkowaną okrągłą kremową tarczę i dwie krótkie nóżki. Użyj obrazu drugiego tylko dla koloru i usłojenia orzecha. Nadaj nóżkom matowe mosiężne wykończenie, a tarczy dwie proste czarne wskazówki. Widok z przodu na jasnej kamiennej powierzchni, miękkie światło boczne, bez oznaczeń marki i dodatkowych przedmiotów.

Ten sam podział działa przy kostiumie: rysunek wyznacza sylwetkę, obraz tkaniny powierzchnię, a zatwierdzony portret fikcyjną osobę, która go nosi. Użyj czystego szkicu bez porzuconych linii. Szkic tylko z przodu nie określa widoku z boku, więc jeśli kontur jest ważny, najpierw poproś o wynik z przodu.

Naprawianie konkretnych problemów

Nowy strój zmienił twarz. Wróć do oryginalnego portretu, usuń dodatkowe osoby z referencji ubioru i zachowaj pierwotny widok. Jeśli twarz ma pozostać dokładna co do piksela, wmontuj zatwierdzoną twarz tradycyjnie, zamiast prosić o kolejne pełne przerysowanie.

Materiał rozlał się na inne obiekty. Nazwij powierzchnię: aksamit należy tylko do marynarki, koszula pozostaje z kremowej bawełny; orzech należy do obudowy zegara, nie do tarczy ani mosiężnych nóżek. Wąska próbka jest czytelniejsza niż całe pomieszczenie użyte jako obraz „stylu”.

Sylwetka szkicu się zmieniła. Uprość szkic i poproś o widok z przodu. Dramatyczny kąt może ukryć kontur, który miał zostać zachowany.

Obiekt jest ucięty. Wybierz ustawienie pasujące do kształtu i poproś o zapas wokół głowy, stóp lub rekwizytu.

Mały logotyp lub fraza jest błędna. Zachowaj scenę i podmień ten element w tradycyjnym edytorze. Bez maski poprawka tekstu to nowe przerysowanie, a nie lokalna łatka.

Powtarzane edycje dryfują. Każde przejście przerysowuje kadr. Przy zmianach kumulatywnych użyj ostatniego zaakceptowanego wyniku i sprawdź, co się przesunęło; jeśli wracasz do oryginału, uwzględnij w prompcie wszystkie zaakceptowane zmiany. Niezależne warianty zaczynaj od wspólnego oryginału.

Koszt i kiedy wybrać inny model

Trzy edycje kosztują 0,09 $, a dziesięć 0,30 $. Większe rozmiary i dodatkowe referencje nie dodają nic. Do nowego obrazu bez źródła użyj Seedream 4.0 tekst na obraz, który ma te same rozmiary i tę samą cenę.

Wybierz 4.0 dla dużych kadrów do 4096*2304 w stałej cenie. Wybierz model 5.0, gdy potrzebujesz aspect_ratio takiego jak 4:5, wyjścia PNG (wszystkie modele 5.0) lub przezroczystego tła (Flash i Pro). Wybierz inną metodę, gdy potrzebujesz maski, zachowanych pikseli lub dokładnej geometrii inżynierskiej. O kreacjach reklamowych ze zdjęć produktów przeczytasz w od zdjęcia produktu do kreacji reklamowej.